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Section I. Overview 

System Interface Overview 

Summarizes the facilities provided by the this release of the UNIX operating system 
for the Sun Workstation. 

Section II. Reference Manual Pages 

1. System Calls — previously section 2 of the UNIX Programmer's Manual. 

2. C Library Functions — section 3. 

3. Compatibility Functions — section 3C. Covers those functions which are included 
for compatibility with older versions of the C Library. 

4. Mathematical Functions — section 3M. 

5. Network Library Functions — section 3N. 

6. Standard I/O Library Functions — section 3S. 

7. Miscellaneous Library Functions — section 3X. 

8. Special Files and Hardware Support — section 4. 

9. File Formats — section 5. 

Section m. Tutorials 

Interprocess Communication (IPC) Primer 



PERMUTED INDEX 

g6tt&b!e - get NIC format host tables from a host gettable(8C) 

i&formatioB file for readnew8(l) and checknew8(l) . newsrc- newsrc(5) 

&eh,w - ran a command at low priority (sh only) . nice nice(l) 

preg^m £le inclnding aliases and paths (csh only) . which - locate a wh!ch(l) 

@: arithmetic on shell variables csh(l) 

login, newgrp, read,/ sh, for, case, if, while, :, ., break, continue, cd, eval, exec, exit, export 8h(l) 

- information Sle for readnews(l) and checknews( 1). newsrc . new9rc(5) 

newsrc - information file for readnew8( 1) and checknew8(l) newsrc(5) 

interface, vp - Ikon 10071-5 Multibus Versatec parallel printer vpC'^S) 

tm - tapemaster 1/2 inch tape drive tm(4S) 

ar - Archive 1/4 inch Streaming Tape Drive ar(4S) 

mti - Systech MTI-800/ 1600 multi-terminal interface mti(4S) 

tm - tapemaster 1/ 2 inch tape drive tm(4S) 

ip - Disk driver for Interphase 2180 SMD Disk Controller ip(^S) 

printer interface, vpc - Systech VPC- 2200 Versatec printer/plotter and Centronics vpc(4S) 

ec - 3Com 10 Mb/s Ethernet interface ec(4S) 

ar - Archive 1/ 4 inch Streaming Tape Drive ar(4S) 

8t - Driver for Sysgen SC 4000 (Archive) Tape Controller 8t(4S) 

vp - Ikon 10071- 5 Multibus Versatec parallel printer interface vp(4S) 

si - Disk driver for Adaptec ST- 506 Disk Controllers. 8d(4S) 

mti - Systech MTI- 800/1600 multi-terminal interface mti(4S) 

IS - lilog 8530 sec serial comnnications driver S8(4S) 

abort - generate a fault. abort(3) 

abort - terminate abruptly with memoiy image abort(3F) 

index, rindex, Inbink, len - tell about character objects. index(3P) 

getrusage - get information about resource utilization getrusage(2) 

vtimes - get information about resource utilisation vtimes(3C) 

fstab - static information about the filesystems f8tab(5) 

abort - terminate abruptly with memory image abort(3P) 

abs - integer absolute value abs(3) 

abs - integer absolute value. ab8(3) 

fabs, fioor, ceil - absolute value, floor, ceiling functions floor(3M) 

ac - login accounting ac(8) 

accept - accept a connection on a socket accept(2) 

accept - accept a connection on a socket accept(2) 

access - determine accessability of a file acce88(3F) 

access - determine accessibility of file acce8s(2) 

getgroups - get group access list getgroup8(2) 

initf roups - initialiie group access list. «... initgroup8(3) 

s^groups - set group access list. 8etgroaps(2) 

access - determine accessability of a file access(3P) 

access - determine accessibility of file acce88(2) 

ac - login accounting. ac(8) 

sa, accton - system accounting. sa(8) 

acct ~ execution accounting file . acct(5) 

pac - printer/plotter accounting information pac(8) 

acct - turn accounting on or off. acct(2) 

acct - execution accounting file acct(5) 

acct - turn accounting on or off acct(2) 

sa, accton - system accounting sa(8) 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions sin(3M) 

signal - change the action for a signal. 8ignal(3F) 

sact - print current SCCS file editing activity. 8act(l) 

fortaae - priat a random, hopefully interesting, adage. foTtune(6) 

sd - Disk driver for Adaptec ST-506 Disk Controllers. 8d(4S) 

adb - debugger. adb(l) 

adbgen - generate adb script. adbgen(8) 

adbgen - generate adb script adbgen(8) 

swapon - add a swap device for interleaved paging/swapping. . . swapon(2) 

addbib - create or extend bibliographic database. . . . addbib(l) 

adduser - procedure for adding new users. addusei(8) 

swapon - specify additional device for paging and swapping 8wapon(8) 

inetjnaof, inet_netof, inet_ntoa - Internet address manipulation. /inet_network, inet_makeaddr, . inet(3N) 

loc - return the address of an object loc(3F) 

arp - address resolution display and control arp(8C) 

arp - Address Resolution Protocol arp(4P) 

mailaddr - mail addressing description. mailaddi(7) 

adduser - procedure for adding new users. ....... adduseifs) 

physical relationships of screens, adjacentscreens - notify the window driver of the . . . adjacent8creens(l) 

admin - create and administer SCCS files admin(l) 

admin - create and administer SCCS files admin(l) 

adventure - an exploration game. adventure(6) 
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T^dvise - give 

flock - apply or remove an 

yea - be repetitively 

bueaame - strip filename 

biff - mail 

time. 



nnalias: remove 

which - locate a program file including 
newaiiases - rebuild the data base for the mail 

aliases - 

valloc - 

malloc, free, realloc, calloc, cfree, 

free, realloc, calloc, cfree, alloca - memory 

valloc - aligned memory 

eyacc - modified yacc 

imemtest - stand 

gxtest - stand 

diag - General-purpose stand- 

scandir, 

limit: 

renice - 

else: 

lex - generator of lexical 

error - 
analyie - ViitniJ UNIX postmoitem crash 

worms - 

rain - 

bed - convert to 

exit - terminate a process after flushing 



flock - 



number - convert 

bc- 

graphics/ openpl, erase, label, line, circle, 

cpio - format of cpio 

ar- 

ar- 

tar - tape 

ar- 

st - Driver for Sysgen SC 4000 ( 

tar - tape 

cpio - copy file 

ranlib - convert 

w - who is on and what they 

users - compact list of users who 

glob: filename expand 

shift: manipulate 

varaigs - v&riable 

echo: echo 

echo - echo 

getarg, iargc - return command line 

expr - evaluate 

getopt, optarg, optind - get option letter from 

mout, pow, gcd, rpow - multiple precision integer 

be - arbitrary-precision 



news - USENET network news 

expire- remove outdated news 

inews - submit news 

postnews - submit news 

readnews - read news 

recnews - receive unprocessed 

recnews - receive unprocessed 

sendnews - send news 

uurec - receive processed news 



advice to paging system ▼advise(2) 

advisory lock on an open file. flock(2) 

affirmative y«s(l) 

affixes. basename(l) 

alarm. biff(l) 

alarm - execute a subroutine after a specified alarm(3P) 

alarm - schedule signal after specified time alarm(3C) 

alias: shell nucros csh(l) 

aliases . C8h(l) 

aliases - aliases file for sendmail aliases(5) 

aliases and paths (csh only) which(l) 

aliases file Bewalia8es(8) 

aliases file for sendmail. aliases(5) 

aligned memory allocator. valloc(3) 

alloca - memoiy allocator. malloc(3) 

allocator, malloc, malloc(3) 

allocator. valloc(3) 

allowing much improved error recovery cyacc(l) 

alone memoiy test. imemte8t(88) 

alone test for the Sun video graphics board gxtest(8s) 

alone utility package diag(88) 

alphasort - scan a directory. 8candii{3) 

alter per-process resource limitations csh(l) 

alter priority of running processes renice(8) 

alternative commands C8h(l) 

analysis programs lcx(l) 

analyie - Virtual UNIX postmortem crash analyser. . . analyse(8) 

analyse and disperse compiler error messages error(l) 

analyier analyze(8) 

animate worms on a display terminal worm8(6) 

animated raindrops display rain(6) 

antique media bcd(6) 

any pending output. . exit(3) 

a.out - assembler and link editor output a.out(5) 

apply or remove an advisory lock on an open file flock(2) 

ar - Archive 1/4 inch Streaming Tape Drive. ..... ai(4S) 

ar - archive and library maintainor ai(l) 

ar - archive (library) file format ai(5) 

Arabic numerals to English numbei(6) 

arbitrary-precision arithmetic language bc(l) 

arc, move, cont, point, linemod, space, closepl - .... plot(3X) 

archive cpio(S) 

Archive 1/4 inch Streaming Tape Drive ai(4S) 

archive and library maintainer. ai(l) 

archive file format. tar(5) 

archive (libraiy) file format ai(5) 

Archive) Tape Controller 8t(4S) 

archiver. iar(l) 

archives in and out. . cpio(l) 

archives to random libraries ranlib(l) 

are doing w(l) 

are on the system. U8er8(l) 

argument list C8h(l) 

argument list C8h(l) 

argument list vararg8(3) 

arguments C8h(l) 

arguments echo(l) 

arguments. getarg(3F) 

arguments as an expression. expi(l) 

argv getopt(3C) 

arithmetic, itom, madd, msnb, mult, mdiv, min mp(3X) 

arithmetic - provide drill in number facts arithmetic(6) 

arithmetic language. . . i bc(l) 

arithmetic on shell variables. C8h(l) 

arp - address resolution display and control. ...... arp(8C) 

arp - Address Resolution Protocol arp(4P) 

article, utility files new8(5) 

articles expire(8) 

articles. inews(l) 

articles postnew8(l) 

»rticle8. readnew8(l) 

articles via mail recnew8(l) 

articles via mail recnew8(8) 

articles via mail sendnew8(8) 

articles via mail nurec(8) 

as - mc68000 assembler Wl) 
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escpr - evalaate argaments as aa expression. ...» . expr(l) 

timeso&e, dysiie - convert date aad time to ASCII, ctime, localtime, gmtime, asctime ctime(3) 

getdate - convert time and date from ASCII. . <,.... getdate(3) 

ascii - map of ASCII character set - a3cii(7) 

ascii - map of ASCII character set ascii(7) 

od - octal, decimal, hex, ascii damp. od(l) 

atof, atoi, atol - convert ASCII to numbers atof(3) 

to ASCII, ctime, localtime, gmtime, asctime, timezone, dysise - convert date and time . . . ctime(3) 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions 8i&(3M) 

help - ask for help help(l) 

as - mc68000 assembler. . as(l) 

a.oat - assembler and link editor output a.out(5) 

assert - program verification assert(3) 

setbuf, setbnffer, setlinebuf - assign buffering to a stream. 3etbuf(3S) 

at - execute commands at a later time. at(l) 

shutdown - close down the system at a given time. 8hutdown(8) 

at -» execute commands at a later time at(l) 

nice, nohup - run & command at low priority (sh only). nice(l) 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions. ........ sin(3M) 

sin, COB, tan, asin, acos, atan, atan2 - trigonometric functions 3in(3M) 

atof, atoi, atol - convert ASCII to numbers atoffS) 

atof, atoi, atol - convert ASCII to numbers. atof(3) 

atof, atoi, atol - convert ASCII to numbers. atof(3) 

interrupt, sigpause - atomically release blocked signals and wait for sigpause(2) 

re - command script for auto-reboot and daemons rc{8) 

wait - await completion of process wait(l) 

awk - pattern scanning and processing language. .... awk(l) 

backgammon - the game of backgammon. ....»....<......... backgammon(8) 

backgammon - the game of backgammon backgammon(6) 

bg: place job in background. cshfl^ 

wait; wait for background processes to complete csh(l) 

banner - print large banner on printer. ........ banner(6) 

banner - print large banner on printer • baaner(6) 

gettytab - terminal conSguratioo data base gettytab(5) 

hosts - host name data base hosts(5) 

networks - network name data base network8(5) 

phones - remote host phone number data base . phones(5) 

priatcap - printer capability data base. . printcap(5) 

protocols - protocol name data base protoco!s(5) 

servers - inrt senrer data base servers(5) 

services - service name data base. . 3ervice8(5) 

termcap - terminal capability data base « termcap(5) 

newaliaaes - rebuild the data base for the mail aliases file. newaliase8(8) 

ttytype - data base of terminal types by port ttytype(5} 

fetch, store, delete, firstkey, nextkey - data base subroutines, dbminit dbm(3X) 

vi - screen oriented (visual) display editor based on ex. . vi(l) 

basename ~ strip filename affixes ba8ename(l) 

be - arbitrary-precision arithmetic language bc(l) 

bed - convert to antique media bcd(6) 

bcopy, bcmp, biero, ffs - bit and byte string operations bstring(3) 

operations, bcopy, bcmp, biero, ffs - bit and byte string b9tring(3) 

Display, bdemos - demonstrate San Monochrome Bitmap .... bdemos(6) 

yes - be repetitively afiTirmative ye8(l) 

cb - C program beautifier. cb(l) 

uptime - show how long system has been up. . aptime(l) 

jo, jl, jn, yO, yl, yn - bessel functions. . jO(3M) 

changing/ random, srandom, initstate, setstate - better random number generator; routines for random(3) 

bg: place job in background csh(l) 

addbib - create or extend bibliographic database addbib(l) 

roffbib ~ run off bibliographic database roffbib(l) 

sortbib-sort bibliographic database 8ortbib(l) 

a bibliography .br lookbib - find references in a bibliography, indxbib - make inverted index to .... indxbib(l) 

bibliography, indxbib - make inverted index to a bibliography .br lookbib - find references in a indxbib(l) 

biff- mail alarm biff(l) 

Comsat - biff server. com8at(8C) 

whereis - locate source, binary, and/or manual for program. wherei8(l) 

- find printable strings in an object, or other binary, file, strings 8tring8(l) 

naencode,uudecode - encode/decode a binary file for transmission via mail. aaencode(lC) 

fread, fwrite - buffered binary input/output fread(3S) 

bind - bind a name to a socket bind(2) 

bind - bind a name to a socket bind(2) 

/ bin/mail - send or receive mail among users binmail(l) 

bcopy, bcmp, bzero, ffs - bit and byte string operations bstring(3) 

bdemos - demonstrate Sun Monochrome Bitmap Display. bdemo8(6) 

strip - remove symbols and relocation bits. . 8trip(l) 

communication, bk - line discipline for machine-machine bk(4) 
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bw - Sua 
gyac - Qpd&te the saper 
sync - update super- 
sync - update the super 
update - periodically update the super 
sigblock - 
sii^pause - atomically release 
sum - sum and count 
- stand alone test for the Sun video graphics 
boggle - play the game of 

ching - the 

reboot - UNIX 

mille - play Mi lie 

indxbib - make inverted index to a bibliography 

switch: multi*way command 

login, newgrp,/ sh, for, case, if, while, :, ., 



more, page - 

bw - Sun black and white frame 

fread, fwrite - 

stdio - standard 

setbuf, setbuffer, setlinebuf - assign 

fbio - general properties of frame 

generate a dump of the operating system's profile 

mknod - 
config - 

- print out manual pages; find manual information 

mkstr - create an error message file 

ttytype - data base of terminal types 

ntohs - convert values between host and network 

bcopy, bcmp, biero, ffs - bit and 

swab - swap 

bcopy, bcmp, 

cc- 

cpp - the 

cb- 

indent - indent and format 

lint - a 

xstr - extract strings from 

mkstr - create an error message file by massaging 

hypot, 

dc - desk 
cal - display 

syscall - indirect system 

gprof - display 

getuid, getgid - get user or group ID of the 

maltoc, free, realloc, 

intro - introduction to system 

canfield, cfscores - the solitaire card game 

canfield. 

printcap - printer 

termcap - terminal 

Oct - Central Data octal serial 

canfield, cfscores - the solitaire 

cribbage - the 

exec, exit, export, login, newgrp, read,/ sh, for. 



ca«maa - create the 
ccat - compress and uncompress files, and 

default: 



them, compact, uncompact, 
sh, for, case, if, while, :, ., break, continue, 



black and white frame buffer. bw(4S) 

block 8ync(l) 

block 8ync(2) 

block Bync(8) 

block ttpdate(8) 

block signals 8igblock(2) 

blocked signals and wait for interrupt iigpau8e(2) 

blocks in a file sum(l) 

board, gxtest gxte8t(89) 

boggle boggle(6) 

boggle - play the game of boggle boggle(6) 

book of changes and other cookies ching(6) 

bootstrapping procedures reboot(8) 

Bomes mille(6) 

.br lookbib - find references in a bibliography indxbib(l) 

branch C8h(l) 

break, continue, cd, eval, exec, exit, export sh(l) 

break: exit while/foreach loop cshfl) 

breaksw: exit from switch. cshfl) 

bring job into foreground C8h(l) 

brk, sbrk - change data segment site brk(2) 

browse through a text file more(l) 

bsuncube - view 3-D Sun logo bsuncube(6) 

buffer bw(4S) 

buffered binaiy input/output fread(3S) 

buffered input/output package intro(3S) 

buffering to a stream 8etbuf(3S) 

buffers fbio(4S) 

buffen. kgmon - kgmon(8) 

build special file mknod(8) 

build system configuration files config(8) 

bw - Sun black and white frame buffer bw(4S) 

by keywords, man man(lj 

by massaging C source taktix(l\ 

by port ttytype(5) 

byte order, htoni, htons, ntohl, b3rteonler(3N) 

byte string operations bstring(3) 

bytes 8wab(3) 

biero, ffs - bit and byte string operations bstring(3) 

C compiler cc(l) 

C language preprocessor. cpp(l) 

C program beautifier cb(l) 

C program source indent(l) 

C program verifier. lint(l) 

C programs to implement shared strings X8tr(l) 

C source mkstifl) 

cabs - Euclidean distance h3rpot(3M) 

cal - display calendar. cal(l) 

calculator dc(l) 

calendar cal(l) 

calendar - reminder service. calendai(l) 

call y8call(2) 

call graph profile data gprof(l) 

caller getuid(3F) 

calloc, cfree, alloca - memory allocator malloc^3) 

calls and error numbers intro(2j 

canfield canfield^e) 

canfield, cfscores - the solitaire card game canfield(6) 

capability data base printcap(5) 

capability data base. termcap(5) 

card oct(4S) 

card game canfield canfield(6) 

card game cribbage cribbage(6) 

case, if, while, :, ., break, continue, cd, eval, h(l) 

case: selector in switch « C8h(l) 

cat - concatenate and display c^^(i) 

cat files for the manual. catman(8) 

cat them, compact, uncompact, compact(l) 

catchall clause in switch csh(l) 

cat man - create the cat files for the manual catman(8) 

cb - C program beautifier cb(l) 

cc - C compiler cc(l) 

ccat - compress and uncompress files, and cat ..... compact(l) 

cd - change working directory cd(l) 

cd: change directory C8h(l) 

cd, eval, exec, exit, export, login, newgrp, read,/ .... 8h(l) 
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delta. 

fabs, floor, 

faba, floor, ceil - absolute valve, floor, 

oct - 

Systech VPC-2200 Versatec printer/plotter and 

malice, free, realloe, calloc, 

canfield, 

chdir - 

brk, sbrk - 

chdir - 

chsh - 

cd: 

chdir 

ioinit - 

chgrp- 

passwd - 

chmod - 

chmod - 

chmod, fchmod - 

amask: 

chowB - 

chown, fchown ~ 

chroot ~ 

signal - 

cdc - 

rename - 

delta - make a delta ( 

set: 

cd- 

ching - the book of 

- better random nnmber generator; routines for 

vi - view a file without 

pip« ~ create an interprocess communication 

ungetc - push 

/isascil, isgraph, tonpper, tolower, toascii - 

eqnchar ~ special 

getc, fgetc - get a 

index, rindex, Inblnk, ten - tell abont 

getc, getchar, fgetc, getw - get 

pute, putchar, fputc, putw - put 

ascii - map of ASCII 

pate, fputc - write a 

tset - establish terminal 

tr ~ translate 

snake, snscore - display 



dcheck ■• file system directory consistency 
icheck - file system storage consistency 

fptype - 

fsck - file system consistency 

checknews ~ 

checknr - 

eqn, neqn, 

fasthalt - reboot /halt the system without 

news network. 

newirc - informatiea file for readnews(l) and 



closepl - graphics/ openpl, erase, label, line, 

isgraph, toupper, tolower, toascii ~ character 

default: catchall 

unclean - cucp spool directory 

ciri - 



cdc - change the delta commentary of an SCCS .... cdc(l) 

ceil - absolute value, floor, ceiling functions floor(3M) 

ceiling functions floor(3M) 

Central Data octal serial card. oct(4S) 

Centronics printer interface, vpc vpc(4S) 

cfree, alloca - memoiy allocator. malloc(3) 

cfscores - the solitaire card game canfield canfield(6) 

eg - Sun color graphics interface cg(4S) 

change current working directoiy chdir(2) 

change data segment size brk(2) 

change default directoiy chdir(3F) 

change default login shell ch8h(l) 

change directoiy csh(l) 

change directory, C8h(l) 

change f77 I/O initialisation ioinit(3F} 

change group chgrp(l) 

change login password pa83wd(l) 

change mode. chmod(l) 

change mode of a file chmod(3F) 

change mode of file chmod(2) 

change or display file creation mask C8h(l) 

change owner. chown(8) 

change owner and group of a file chown(2) 

change root directoiy chroot(2) 

change the action for a signal signal(3F) 

change the delta commentary of an SCCS delta cdc(l) 

change the name of a file rename(2) 

change) to an SCCS file delta(l) 

change value of shell variable C8h(l) 

change working directory cd(l) 

changes and other cookies ching(6) 

changing generators, /srandom, initstate, setstate . . . random(3) 

changing it using the vi visual editor. view(l) 

channel » pipe(2) 

character back into input stream ungetc(3S) 

character classification and conversion macros ctype(3) 

character definitions for eqn eqnchar(7) 

character from a logical unit getc(3F) 

character objects index(3F) 

character or integer from stream getc(3S) 

character or word on a stream putc(3S) 

character set. . a8cii(7) 

character to a FORTRAN logical unit putc(3F) 

characteristics for the environment t8et(l) 

characters ti^l) 

chase - Tiy to escape to killer robots. cha8e(6) 

chase game. > snake(6) 

chdir - change current workmg directory chdir(2) 

chdir - change default directory chdir(3F) 

chdir: change directoiy. C8h(l) 

check dcheck(8) 

check. .......... icheck(8) 

check a floating point number fptype(3F) 

check and interactive repair f8ck(8) 

check if user has news on the USENET news network. . checknews(l) 

check nroff/troff files checknr(l) 

checkeq - typeset mathematics eqit(l) 

checking the disks, fastboot, . . > fastboot(8) 

checknews ~ check if user has news on the USENET . . checknew8(l) 

cheeknews(l)< . newsrc(5) 

checknr - check nroff/troff files checknr(l) 

chgrp - change group chgrp(l) 

ching ~ the book of changes and other cookies ching(6) 

chmod - change mode. chmod(l) 

chmod - change mode of a file chmod(3F) 

chmod, fchmod - change mode of file chmod(2) 

chown - change owner chown(8) 

chown, fchown ~ change owner and group of a file. . . . chown(2) 

chroot - change root directory chroot(2) 

chsh - change default login shell chsh(l) 

circle, arc, move, cont, point, linemod, space, plot(3X) 

classification and conversion macros, /isascii ct3rpe(3) 

clause in switch C8h(l) 

clean-up. unclean(8C) 

clear - clear workstation or terminal screen clear(l} 

clear i-node clri(8) 
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clear - 

ferror, feof, 

csh - X shell (command interpreter) with 

croB - 

shatdowD - 

fclose, Slash - 

opendir, readdir, telldir, seekdir, revinddir, 

syslog, openlog, 

circle, arc, move, cont, point, linemod, space, 



pi - Pascal interpreter 



log. dmesg- 

colordemoi - demonstrate Sun 

eg- San 

Display. 

pr - print file(s), possibly in multiple 
colrm - remove 

comb - 

files. 

exec: overlay shell with specified 

time: time 

- routines for returning a stream to a remote 

rexec - retnm stream to a remote 

system - issue a shell 

system - execute a UNIX 

test - condition 

time - time a 

nice, nohup - run a 

switch: multi-way 

uux - Unix to Unix 

rehash: recompute 

nnhash: discard 

hashstat: print 

nohup: run 

csh - a shell ( 

whatis - describe what a 

readonly, set, shift, times, trap, umask, wait - 

getarg, iargc ~ return 

repeat: execute 

re - 

onintr: process interrupts in 

goto: 

else: alternative 

intro - introduction to 

introduction to system maintenance and operation 

at - execute 
while: repeat 
lastcomm - show last 
source: read 
cdc - change the delta 
comm - select or reject lines 
bk - line discipline for machine-machine 
socket - create an endpoint for 
pipe - create an interprocess 
users - 
files, and cat them, 
diff - differential file and directory 
cmp - 
sccsdiff - 
diff3 - ^way differential file 
intro - introduction to 
cc-C 
m - FORTRAN-77 
pc - Pascal 
yacc - yet another compiler- 
error - analyse and disperse 
yacc - yet another 
wait: wait for background processes to 
wait - await 
compact, uQcompact, ccat - 



clear workstation or terminal screen clear(l) 

clearerr, fileno - stream status inquiries ferror(3S) 

C-like syntax C8h(l) 

clock daemon cron(8) 

close - delete a descriptor close(2) 

close down the S3rstem at a given time. shutdown(8) 

close or flush a stream fclose(3S) 

closedir - directory operations directoiy(3) 

closelog - control system log 8yslog(3) 

closepl - graphics interface, /erase, label, line pIot(3X) 

ciri - clear i-node clri(8) 

cmp - compare two files cmp(l) 

code translator pi(l) 

col - filter reverse paper motions col(l) 

colcrt - filter nroff output for CRT previewing colcrt(l) 

collect system diagnostic messages to form error .... dmesg(8) 

Color Graphics Display colordemos(6) 

color graphics interface cg(4S) 

colordemos - demonstrate Sun Color Graphics colordemos(6) 

colrm - remove columns from a file colrm(l) 

columns pr^l) 

columns from a file colrm(l) 

comb - combine SCCS deltas combfl) 

combine SCCS deltas comb(l j 

comm - select or reject lines common to two sorted . . . comm(l) 

command. cshfl) 

command csh(l) 

command, rcmd, rresvport, ruserok rcmd(3N) 

command rexec(3N) 

command system(3) 

command sy8tem(3F) 

command test(l) 

command time(l) 

command at low priority (sh only) nice(l) 

command branch csh(l) 

command execution. uax(lC) 

command hash table csh(l) 

command hajh table cshm 

command hashing statistics C8h(l) 

command immune to hangups. . csh(l) 

command interpreter) with C-like syntax csh(i) 

command is. whati8(l) 

command language, /export, login, newgrp, read, . . . sh(l) 

command line arguments getarg(3F) 

command repeatedly C3h(l) 

command script for auto-reboot and daemons rc(8) 

command scripts. cshfl) 

command transfer. C8h(i) 

commands C8h(l) 

commands. intro(l) 

commands, intro . intro(8) 

commands at a later time at(l) 

commands conditionally c8h(l) 

commands executed in reverse order la8tcomm(l) 

commands from file C8h(l) 

commentary of an SCCS delta cdc(l) 

common to two sorted files comm(l) 

communication bk(4) 

communication. 8ocket(2) 

communication channel. pipK^) 

compact list of users who are on the system aser8(l) 

compact, uncompact, ccat - compress and uncompress . compact(l) 

comparator diff(l) 

compare two files cmp(l) 

compare two versions of an SCCS file 8cc8diff(l) 

comparison. diff3(l) 

compatibility libraiy functions intro(3C) 

compiler cc(l) 

compiler. f77(l) 

compiler pc(l) 

compiler. yacc(l) 

compiler error messages error^l) 

compiler-compiler yacc(l) 

complete . C8h(l) 

completion of process. wait(l) 

compress and uncompress files, and cat them compact(l) 
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hangm&B - 

f8 - lilog 8530 sec serial 

cat- 

test- 

endif: terminate 

if: 

white: repeat commands 

gettytab - terminal 

config - build system 

ifconfig - 

tip, cti - 

getpeername - get name of 

socketpair - create a pair of 

shatdowB - >bat down part of a full-daplex 

accept - accept a 

connect - initiate a 

listen - listen for 

dcbeck - file system directory 

icheck - file system storage 

fsck - file system 

cons - driver for San 

mkfs - 

newfs - 

mkproto - 

deroff - remove nroff, troff, tbi and eqn 

setrlimit - control maximum system resonrce 

vlimit - control maximum system resource 

openpl, erase, label, line, circle, arc, move. 

Is - list 

sigstack - set and/or get signal stack 

lockscreen - maintain window 

newgrp,/ sb, for, case, if, while, :, ., break, 

arp - address resolution display and 

fcntl - file 

nd - network disk 

ioctl - 

init ~ process 

getriimit, setrlimit - 

vlimit - 

icmp - Internet 

dkio - generic disk 

fcntl - file 

Ipc - line printer 

tcp - Internet Transmission 

syslog, openlog, closelog - 

vhangup - virtually "hangup" the current 

ip - Disk driver for Interphase 2180 SMD Disk 

st - Driver for Sysgen SC 4000 (Archive) Tape 

sd - Disk driver for Adaptec ST>506 Disk 

xy - Disk driver for Xylogics SMD Disk 

ecvt, fcvt, gcvt - output 

printf, fprintf, sprintf - formatted output 

scanf, fscanf, sscanf - formatted input 

tolower, toascii - character classification and 

units - 

vswap - 

dd- 

number - 

ranlib - 

atof, atoi, atoi - 

localtime, gmtime, asctime, timesone, dysise - 

htable - 

getdate - 

bcd- 

htonl, htons, ntohl, ntohs - 

ching - the book of changes and other 

rep - remote file 

uncp, ualog - unix to unix 

dd - convert and 

cpio - 

cp- 



Compnter version of the game hangman hangman(6) 

Comsat - biff server. com8at(8C) 

comunications driver i8(4S) 

concatenate and display. cat(l) 

condition command test(l) 

conditional C8h(l) 

conditional statement csh(l) 

conditionally csh(l) 

config - build system configuration files coDfig(8) 

configuration data base gettytab(5) 

configuration files config(8) 

configure network interface parameters ifconfig(8C) 

connect - initiate a connection on a socket connect(2) 

connect to a remote system tip(lC) 

connected peer getpeername(2) 

connected sockets socketpaii(2) 

connection. shtttdown(2) 

connection on a socket accept(2) 

connection on a socket connect(2) 

connections on a socket Ii8ten(2) 

cons - driver for Sun console con8(4S) 

consistency check dcheck(8) 

consistency check icheck(8) 

consistency check and interactive repair fsck(8) 

console con8(4S) 

construct a file system mkf8(8) 

construct a new file system newf8(8) 

construct a prototype file system mkproto(8) 

constructs deroff(l) 

consumption, getriimit getriimit(2) 

consumption vlimit(3C) 

cont, point, linemod, space, closepl - graphics/ plot(3X) 

contents of directory l8(l) 

context sig8tack(2) 

context until "login" lock8creen(l) 

continue, cd, eval, exec, exit, export, login, sh(l) 

continue: cycle in loop csh(l) 

control. . arp(8C) 

control fcntl(2) 

control nd(8C) 

control device ioctl(2) 

control initialisation init(8) 

control maximum system resource consumption getrlimit(2) 

control maximum system resource consumption vlimit(3C) 

Control Message Protocol icmp(4P) 

control operations dkio(4S) 

control options fcntl(5) 

control program. Ipc(8} 

Control Protocol tcp(4P) 

control system log 8y8log(3} 

control terminal vhangup(2) 

Controller. ip(4S) 

Controller. st(4S) 

Controllers sd(4S) 

Controllers xy(4S) 

conversion ecvt(3) 

convenion printf(3S) 

conversion 8canf(3S) 

conversion macros, /isascii, isgraph, toupper ctype(3) 

conversion program. units(l) 

convert a foreign font file V8wap(l) 

convert and copy a file. ^d(l) 

convert Arabic numerals to English. . number(6) 

convert archives to random libraries ranlib(l) 

convert ASCII to numbers atof(3) 

convert date and time to ASCII, ctime, ctime(3) 

convert NIC standard format host tables htable(8) 

convert time and date from ASCII getdate(3) 

convert to antique media bcd(6) 

convert values between host and network byte order. . . byteorder(3N) 

cookies ching(6) 

copy rcp(lC) 

copy uucp(lC) 

copy a file dd(l) 

copy file archives in and out cpio(l) 

copy files cp(l) 
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fork - create a 
tee- 

savecore - save a 

gcore - jet 

fsync - sycchroniie a file's in* 

fanctioas. sin, 

sinh, 

irc - word 

snm - snm and 



epic - format of 



analyxe - Virtual UNIX postmoitem 
crash - what happens when the system 

fork- 

tmpnam - 

creat - 

open - open a file for reading or writing , or 

fork- 

socketpair - 

ctags - 

socket - 

mkstr - 

pipe- 

admin - 

addbib - 

catman - 

nmask: change or display file 

nmask - set file 

cribbage - the card game 



pxref - Pascal 
colcit - filter nroff output for 



syntax, 
locate a program file including aliases and paths ( 

- convert date and time to ASCII. 

tip, 

vhangup - virtually "hangup" the 

gethostid - get unique identifier of 

gethostname, sethostname - get/set name of 

hostnm - get name of 

hostid - print identifier of 

hostname - set or print name of 

jobs: print 

sun - is 

vax - is 

sact - print 

sigsetmask - set 

whoami - display effective 

chdir - change 

getcwd - get pathname of 

getwd - get 

motion. 

curses - screen functions with "optimal" 

spline - interpolate smooth 

continue: 

bsuncube - view S- 

cron - clock 

inetd - internet services 

Ipd - line printer 

routed - network routing 

re - command script for auto-reboot and 

ftpd- 

telnetd - 

timed - 

tftpd - 



copy of this process fork(3F) 

copy standard output to many files ^^^0 

core - format of memory ima^e file core(5) 

core dump of the operating system savecore(8) 

core images of running processes gcor^l) 

core state with that on disk f8ync(2) 

cos, tan, asin, acos, atan, atan2 - trigonometric .... 8in(3M) 

cosh, tanh - hyperbolic functions 8inh(3M) 

count wc(l) 

count blocks in a file sum(l) 

cp - copy files cp(l) 

cpio - copy file archives in and out cpio(l) 

cpio - format of cpio archive cpiofS) 

cpio archive cpio(5) 

cpp - the C language preprocessor. cpp(l) 

crash - what happens when the system crashes cra8h(88) 

crash analyser analyse(8) 

crashes cra8h(8s) 

creat - create a new file creat(2) 

create a copy of this process fork(3F) 

create a name for a temporary file ^ tmpnam(3C) 

create a new file creat(2) 

create a new file open(2} 

create a new process. fork(2) 

create a pair of connected sockets 80cketpair(2) 

create a tags file ctag8(l) 

create an endpoint for communication 80cket(2) 

create an error message file by massaging C source. . . . mkstr(l) 

create an interprocess communication channel pipc(2) 

create and administer SCCS files . admin(l) 

create or extend bibliographic database addbib(l) 

create the cat files for the manual catman(8) 

creation mask csh(l) 

creation mode mask. uma8k(2) 

cribbage. cribbagef6) 

cribbage - the card game cribbage cribbage(6) 

cron - clock daemon. cron(8) 

crontab - table of times to run periodic jobs crontab(5) 

cro8s>reference program pxref(l) 

CRT previewing colcrt(l) 

crypt - encode/ decode. cryptfl) 

crypt, setkey, enciypt - DES encryption crypt(3) 

csh - a shell (command interpreter) with C-like .... C8h(l) 

csh only), which ~ which(l) 

ctags - create a tags file ctag8(l) 

ctime, localtime, gmtime, asctime, timeione, dysiie . . . ctime(3) 

en - connect to a remote system tip(ic3) 

current control terminal vhangup(2) 

current host gethostid(2) 

current host. gethostname(2) 

current host hostnm(3F) 

current host system hostid(l) 

current host system ho8tname(l) 

current job list C8h(l) 

current machine a sun workstation sunfl) 

current machine a vax ^^U) 

current SCCS file editing activity sact(l) 

current signal mask 8ig8etmask(2) 

current nsemame whoami(l) 

current working directory. chdir(2) 

current working directory getcwd(3F) 

current working directory pathname getwdfS) 

curses - screen functions with "optimal" cursor .... cune8i3X) 

cursor motion cur8e8(3X) 

curve » 8pline(lG) 

cycle in loop C8h(l) 

D Sun logo. b8uncub<5(6) 

daemon cron(8) 

daemon inetd(8C) 

daemon Ipd(8) 

daemon routed(8C) 

daemons rc(8) 

DARPA Internet File Transfer Protocol server ftpd(8C) 

DARPA TELNET protocol server. telnetd(8C) 

DARPA Time server timed(8C) 

DARPA Trivial File Transfer Protocol server tftpd(8C) 
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eval: re-«va.laa,te shell 

Kprof - display call graph profile 

prof - display profile 

ttys - terminal initialization 

gettytab - terminal configuration 

hosts - host name 

networks - network name 

phones - remote host phone number 

printcap - printer capability 

protocols - protocol name 

servers - inet server 

services - service name 

termcap - terminal capability 

newaliasei - rebuild the 

ttytype - 

dbminit, fetch, store, delete, firstkey, nextkey - 

Oct - Central 

brk, sbrk - change 

null- 

types - primitive system 

addbib - create or extend bibliographic 

roffbib - ran off bibliographic 

sortbib - sort bibliographic 

join - relational 

udp - Internet User 

date - display or set the 

gettimeofday, settimeofday ~ get /set 

time, ftime - get 

gmtime, asctime, timeione, dysiie ~ convert 

rdate - set system 

getdate - convert time and 

touch - update 

idate, itime - return 

data base subroutines. 



adb- 

dbx- 

od - octal, 

tp- 

ciypt - encode/ 

uuencode.uudeeode - encode/ 

chdir - change 

chsh - change 

kbd - k^board translation table format and 

eqnchar - special character 

close - 

dbminit, fetch, store, 

cdc - change the delta commentary of an SCCS 

delta - make a 

cdc - change the 

rmdel - remove a 

comb - combine SCCS 

colordemos - 

bdemos - 

mesg - permit or 

constructs. 

crypt, setkey, encrypt - 

whatis ~ 

mailaddr - mail addressing 

remote - remote host 

close - delete a 

dup, dup2 - duplicate a 

getfstype, setfsent, endfsent - get file system 

getfd - get the file 

getdtablesiie - get 

dc- 

access ~ 

access - 

file- 

drum - paging 



data C8h(l) 

data gprof(l) 

data prof(l) 

data ttys(5) 

data base gettytab(5) 

data base ho8ts(5) 

data base networks(5) 

data base phone8(5) 

data base printcap(5) 

data base protocoIs(5) 

data base servers(5) 

data base service8(5) 

data base termcap(5) 

data base for the mail aliases file newaliases(8) 

data base of terminal types by port ttytype(5) 

data base subroutines dbm(3X} 

Data octal serial card oct(4S) 

data segment siie brk(2) 

data sink null(4) 

data types. « types(5) 

database. addbib(l) 

database. roffbib(l) 

database sortbib(l) 

database operator. join(l) 

Datagram Protocol udp(4P) 

date. . date(l) 

date - display or set the date date(l) 

date and time. gettimeofday(2) 

date and time. « time(3C) 

date and time to ASCII, ctime, localtime ctime(3) 

date from a remote host. rdate(8) 

date from ASCII getdat^S) 

date last modified of a file touch(l) 

date or time in numerical form. idate(dF) 

dbminit, fetch, store, delete, firstkey, nextkey - .... dbm(3X) 

dbx - debugger dbx(l) 

dc - desk calculator. dc(l) 

dcheck - file system directoiy consistency check dcheck(8) 

dd - convert and copy a file dd(l) 

debugger. adb(l) 

debugger. . dbx(l) 

decimal, hex, ascii dump od(l) 

DE^/mag tape formats tp(5) 

decode. ........... crypt(l) 

decode a binary file for transmission via mail uuencode(lC) 

default catchall clause in switch C8h(l) 

default directoiy. chdir(3P) 

default login shell ch8h(l) 

default table kbd(5) 

definitions for eqn eqnchar(7) 

delete a descriptor clo8e(2) 

delete, firstkey, nextkqr - data base subroutines. .... dbm(3X) 

delta cdc(l) 

delta - make a delta (change) to an SCCS file delta(l) 

delta (change) to an SCCS file delta(l) 

delta commentary of an SCCS delta cdc(l) 

delta from an SCCS file rmdel(l) 

deltas. . > comb(l) 

demonstrate Sun Color Graphics Display colordemo8(6) 

demonstrate Sun Monochrome Bitmap Display bdemos(6) 

deny messages. mesg(l) 

deroff - remove nroff, troff, tbi and eqn deroff(l) 

DBS enciyption ciypt(3) 

describe what a command is whati8(l) 

description mailaddr(7) 

description file. remote(5) 

descriptor. clo8e(2) 

descriptor. dttp(2) 

descriptor file entry, /getfsspec, getfsfile getf8ent(3) 

descriptor of an external unit number getfd(3F) 

descriptor table size getdtablesize(2) 

desk calculator. > . dc(l) 

determine accessability of a file acce8s(3P) 

determine accessibility of file acces8(2) 

determine file type file(l) 

device. drum(4) 
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fold - fold long tines for finite width output 

iocti - control 

8w»pon - »dd a swap 

swapon - specify additional 

flmin, flmax, dflmin, 

flmin, flnux, 

package. 

dmess - collect system 

tatfor - rational Foitraa 



diff- 
diffS - 3-way 

dir - fonnat of 

rm, nndir - remove (unlink) files or 

rmdir, rm - remove (unlink) 

cd - change working 

chdir - change current working 

chdir - change default 

chroot - change root 

cd: change 

chdir: change 

getcwd - get pathname of current working 

Is - list contents of 

mkdir - make a 

scandir, alphasort - scan a 

unclean - uucp spool 

diff - differential file and 

dcheck - file system 

unlink - remove 

unlink - remove a 

mkdir - make a 

rmdir - remove a 

pwd - print working 

readdir, telldir, seekdir, rewinddir, closedir - 

getwd - get current working 

popd: pop shell 

pushd: push shell 

setquota - enable/ 

unhash: 

unset: 

bk - line 

- synchronise a file's in-core state with that on 

nd - network 

dkio - generic 

ip - Disk driver for Interphase 2180 SMD 

sd - Disk driver for Adaptec ST-506 

xy - Disk driver for Xylogics SMD 

nd - network 

sd- 

Controller. ip - 

xy- 

quota - manipulate 

df - report free 

du - summarise 

- reboot/halt the system without checking the 

mount, umount - mount and 

error - analyse and 

bdemos - demonstrate Sun Monochrome Bitmap 

cat - concatenate and 

colordemos - demonstrate Sun Color Graphics 

rain - animated raindrops 

arp - address resolution 

cal- 

gprof- 

snake, snscore - 

vi - screen oriented (visual) 

whoami - 

nmask: change or 

head - 

peifmon - graphical 

date- 

prof - 

worms - animate worms on a 



device fold(l) 

device ioctl(2) 

device for interleaved paging/swapping 8wapon(2) 

device for paging and swapping 8wapon(8) 

df - report free disk space on file systems. df(l) 

dflmax, inmax - return extreme values. range^SF) 

dflmin, dflmax, inmax - return extreme values range(3F) 

diag - General-purpose stand-alone utility diag(8s) 

diagnostic messages to form error log dmesg(8) 

dialect ratfor(l) 

diff - differential file and directory comparator. ..... diff(l) 

diffS - 3-way differential file comparison diff3(l) 

differential file and directory comparator difif(l) 

differential file comparison diffSfl) 

dir - format of directories dir{5) 

directories diriS) 

directories nii(l) 

directories or files rmdir(l) 

directory. cd(l) 

directory chdir(2) 

directory chdir(3F) 

directory chroot(2) 

directory cshfl) 

directory csh(l) 

directory getcwd(3F) 

directory. l8(l) 

directory. mkdii(l) 

directory 8candir(3) 

directory clean-up uuclean(8C) 

directory comparator diff(l) 

directory consistency check dcheck(8) 

directory entiy nnlink(2) 

directory entry. unlink(3F) 

directory file. mkdii(2) 

directory file rmdir(2) 

directory name pwd(l) 

directory operations, opendir, directory(3) 

directory pathname getwd(3) 

directory stack csh(l) 

directory stack. . C8h(l) 

disable quotas on a file system setquota(2) 

discard command hash table cshfl) 

discard shell variables, csh(l) 

discipline for machine-machine communication bk(4) 

disk, fsync f8ync(2) 

disk control nd(8C) 

disk control operations dkio(4S) 

Disk Controller ip(4S) 

Disk Controllers. sd(4S) 

Disk Controllers. xyf4S) 

disk driver nd(4P) 

Disk driver for Adaptec ST-506 Disk Controllers sd(4S) 

Disk driver for Interphase 2180 SMD Disk . ip('lS) 

Disk driver for Xylogics SMD Disk Controllers xy(4S) 

disk quotas qiiota(2) 

disk space on file systems df(l) 

disk usage <1q(1) 

disks, fastboot, fasthalt fa8tboot(8) 

dismount file system mount(8) 

dispene compiler error messages error(l) 

Display bdemo8(6) 

display cat(l) 

Display colordemoB(6) 

display rain(6) 

display and control. arp(8C) 

display calendar. cal(l) 

display call graph profile data gprof(l) 

display chase game sDake(6) 

display editor based on ex . Yi(i) 

display effective current useraame whoami(l) 

display file creation mask C8h(l) 

display first few lines of specified files head(l) 

display of generd system statistics perfmon(l) 

display or set the date date(l) 

display profile data prof(l) 

display terminal worm8(6) 
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tail - 
hypot, cabs - Eaclidean 

error log. 

refer - find and insert literature references in 

troff - typeset or format 

w - who is on and what th^r are 

shutdown - shut 

shutdown - close 

graph - 

draw - interactive graphics 

arithmetic - provide 

ar - Archive 1/4 inch Streaming Tape 

tm - tapemaster 1/2 inch tape 

nd - network disk 

pty - psendo terminal 

ss - lilog 8530 sec serial comunications 

sd - Disk 

ip - Disk 

cons - 

Controller, st - 

xy - Disk 

adjacentscreens - notify the window 

term - terminal 

term - terminal 



damp - incremental file system 
ed - octal, decimal, hex, ascii 



dumpfs - 

damp, dumpdates - incremental 

savecore - save a core 

kgmoB - generate a 

dump. 



dap, 

shotdowB - shat down part of a fulU 

dap, dap2 - 

ctime, loealtime, gmtime, asctime, timeione, 



echo: 
echo- 



end, etext, 

«, 

vipw - 

sact - print current SCCS file 

ed - text 

ex, edit - text 

Id - link 

sed - stream 

view a file without changing it using the vi visual 

vi - screen oriented (visual) display 

a.ont - assembler and link 

whoami ~ display 

setregid - set real and 

setreuid - set real and 

vfork - spawn new process in a virtual memory 

frep, 

insque, remque - insert /remove 

soelim - 

tektool - Tektronix 4014 terminal 

setquota - 

nuencode - format of an 

crypt - 

mail. uaencode,uadecode - 

crypt, set key, 



display the last part of a file tail(l) 

distance. hypot(3M) 

dkio - generic disk control operations '. . . . dkio{4S) 

dmesg - collect system diagnostic messages to form . . . dme8g(8) 

documents refer(l) 

documents troff(l) 

doing o w(l) 

down part of a fuii-daplex connection shutdown(2) 

down the system at a given time shutdown(8) 

draw - interactive graphics drawing draw(6) 

draw a graph graph(lG) 

drawing draw(6) 

drill in number facts arithmetic(6) 

Drive. . ai<4S) 

drive tm(4S) 

driver. nd(4P) 

driver. pty(4) 

driver. ss(4S) 

driver for Adaptec ST-S06 Disk Controllers d(4S) 

driver for Interphase 2180 SMD Disk Controller. .... ip(4S) 

driver for Sun console. . cons(4S) 

Driver for Sysgen SC 4000 (Archive) Tape st(4S) 

driver for Xylogics SMD Disk Controllers xy(4S) 

driver of the physical relationships of screens adjacentscreen8(l) 

driving tables for nroff term(5) 

driving tables for nroff. term(5) 

drum - paging device. dram(4) 

du - summarise disk usage da(l) 

dump damp(8) 

dump od(l) 

dump - incremental file system dump dump(8) 

dump, dumpdates - incremental dump format dump(5) 

dump file system information dumpfs(8) 

damp format dump(5) 

dump of the operating system savecore(8) 

dump of the operating system's profile buffers kgmon(8) 

dumpdates - incremental dump format dump(5) 

dumpfs - dump file system information dumpf8(8) 

dup, dup2 - duplicate a descriptor dup(2) 

dup2 - duplicate a descriptor dap(2) 

duplex connection. shatdown(2) 

duplicate a descriptor. dap(2) 

dysiie - convert date and time to ASCII ctime(3) 

ec - 3Com 10 Mb/s Ethernet interface ec(4S) 

echo - echo arguments echo(l) 

echo arguments csh(l) 

echo arguments. echo(l) 

echo: echo arguments csh(l) 

ecvt, fcvt, gcvt - output conversion ecvt(3) 

ed - text editor ed(l) 

edata - last locations in program end(3) 

edit - text editor ex(l) 

edit the password file vipw(8) 

editing activity sact(l) 

editor. ed(l) 

editor. ex(l) 

editor ld(l) 

editor sed(l) 

editor, vi - view(l) 

editor based on ex vi(l) 

editor output. a.oat(5) 

effective current usemame. whoami(l) 

effective group ID setregid(2) 

effective user ID's 8etreaid(2) 

efficient way. . vfork(2) 

egrep, fgrep - search a file for a pattern Sivp(l) 

element from a queue in8qae(3) 

eliminate .so's from nroff input soelim(l) 

else: alternative commands csh(l) 

emulator tool. . tektool(l) 

en - Sun 3 Mb/s experimental Ethernet interface. . . . en(4S) 

enable/disable quotas on a file system setqaota(2) 

encoded nuencode file aaencode(5) 

encode/decode. . crypt(l) 

encode/decode a binary file for transmission via .... uuencode(lC) 

encrypt - DES encryption crypt(3) 
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crypt, setkey, encrypt - DES 
m&kekey - generate 

8CC8 - front 
logout: 

/getfsspec, getfsfile, getfstype, setfsent, 

getgrent, getgrgid, getgmam, setgrent, 

gethovtby&ddr, gethostbynune, aethostent, 

getnetent, getnetbyaddr, getnetbyname, setnetent, 

socket - create an 

getprotobynnmber, getprotobyname, setprotoent, 

getpwent, getpwaid, getpwnam, setpwent, 

getservbyport, gettervbyname, setseivent, 

number - convert Arabic numerals to 

xsend, xget, 

nlist - get 

endfsent - get file system descriptor file 

getgmam, setgrent, endgrent - get group file 

sethostent, endhostent - get network host 

getnetbyname, setnetent, endnetent - get network 

setprotoent, endprotoent - get protocol 

getpwnam, setpwent, endpwent - get password file 

setservent, endservent ~ get service 

sysiog - make system log 

unlink - remove directory 

unlink - remove a directory 

execl, execv, execle, execlp, execvp, 

setenv: set variable in 

environ - user 

printenv - print out the 

suntools - the Suntools window 

tset - establish terminal characteristics for the 

getenv - value for 

unsetenv: remove 

getenv - get value of 

eqnchar - special character definitions for 

deroff - remove nroff, troff, tbi and 



linemod, space, cloiepl - graphics/ openpl, 

perror, sys.errlist, sys^nerr, 

messages. 

dmesf - collect system diagnostic messages to form 

mkstr - create an 

error - analyse and disperse compiler 

perror, syijerrlist, sys^nerr, errno - system 

perror, gerrer, iermo - get system 

intro - introduction to system calls and 

eyacc - modified yacc allowing much improved 

spell, spellin, spellout - find spelling 

chase - Try to 

environment, tset - 

end, 

ec - SCom 10 Mb/s 

en - Sun 3 Mb/s experimental 

hypot, cabs - 

for, case, if, while, :, ., break, continue, cd, 

expr- 
eval: re- 
history: print history 
- screen oriented (visual) display editor based on 

Ipq - spool queue 
/case, if, while, :, ., break, continue, cd, eval, 

execute a file. 

exed, execv, 

execl, execv, execle, 

sticky - 

execl, execv, execle, execlp, execvp, environ - 

execve - 



encryption. crypt(3) 

encryption key makekqr(8) 

end, etext, edata - last locations in program end(3) 

end for the .SM SCCS subsystem. scc8(l) 

end session C8h(l) 

end: terminate loop C8h(l) 

endfsent - get file system descriptor file entry getf8ent(3) 

endgrent - get group file entry getgrent(3) 

endhostent - get network host entry, gethostent, . . . gethostent(3hO 

endif: terminate conditional csh(l) 

endnetent - get network entry getnetent(3N) 

endpoint for communication socket(2) 

endprotoent - get protocol entry, getprotoent getprotoent(3N) 

endpwent - get password file entry getpwent(3) 

endservent - get service entry, getservent, getservent(3N) 

endsw: terminate switch csh(l) 

English number(6) 

enroll - secret mail xsend(l) 

entries from name list nlist(3) 

entry, /getfsspec, getf8file, getfstype, setfsent getf8ent(3) 

entry, getgrent, getgrgid getgrent(3) 

entry, gethostent, gethostbyaddr, gethostbyname, . . . getho8teDt(3N) 

entry, getnetent, getnetbyaddr getneteBt(3N) 

entiy. /getprotobynnmber, getprotobyname, getprotoent(3N) 

entry, getpwent, getpwuid getpwent(3) 

entry, getservent, getservbjrport, getservbyname, . . . get8ervent(3N) 

entry sy8log(l) 

entry unlink(2) 

entry unlink(3F) 

environ - execute a file execl(3) 

environ - user environment environ(5) 

environment. csh(l) 

environment environ(5) 

environment printenv(l) 

environment suntools(l) 

environment t8et(l) 

environment name getenv(3) 

environment variables C8h(l) 

environment variables. getenv(3F) 

eq> eqnchar(7) 

eqn constructs. deroff(l) 

eqn, neqn, checkeq - typeset mathematics cqn(l) 

eqnchar - special character definitions for eqn eqnchar(7) 

erase, label, line, circle, arc, move, cont, point plot(3X) 

errno - system error messages perror(3) 

error - analyse and disperse compiler error erTor(l) 

error log. dme8g(8) 

error message file by massaging C source mkstr^l) 

error messages « error(l) 

error messaged. perror(3) 

error messages penor(3F) 

error numbers intro(2) 

error recovery eyacc(l) 

errors spell(l) 

escape to killer robots chase(6) 

establish terminal characteristics for the tset(l) 

etext, edata - last locations in program end(3) 

Ethernet interface ec(4S) 

Ethernet interface en(4S) 

Euclidean distance hypot(3M) 

eval, exec, exit, export, login, newgrp, read,/ sh 8h(l) 

eval: re-evaluate shell data csh(l) 

evaluate arguments as an expression. expr(l) 

evaluate shell data csh(l) 

event list C8h(l) 

ex. vi vi(i) 

ex, edit - text editor cx(l) 

examination program . |pq(l) 

exec, exit, export, login, newgrp, read, readonly,/ . . . 8h(l) 

exec: overlay shell with specified command C8h(l) 

exed, execv, execle, execlp, execvp, environ - execl(3) 

execle, exedp, execvp, environ - execute a file execl(3) 

execlp, execvp, environ - execute a file execl(3) 

executable files with persistent text sticky(8) 

execute a file execl(3) 

execute a file execve(2) 
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alarm - 

system - 

repeat: 

at- 

lastcomm - show last commands 

Qox - anix to nnix command 

acct - 

sleep - suspend 

sleep - suspend 

sleep - suspend 

monitor, monstartnp, moncontrol - prepare 

pxp - Pascal 

rexecd - remote 

profil - 

pbc - Pascal interpreter and 

file, execl, 

execl, execv, execle, execlp, 

link, symink - make a link to an 

tunefs - tune up an 

pending output. 

/if, while, :, ., break, continue, cd, evai, exec, 

breaksw: 

break: 

logarithm, power, square root. 

glob: filename 

expand, unexpand - 

vena. 

en - Sun 3 Mb/s 

adventure - an 

frexp, Idexp, mod! - split into mantissa and 

^Pi log, loglO, pow, sqrt - 

/while, :, ., break, continue, cd, eval, exec, exit, 

expr - evaluate arguments as an 

re.comp, re^exec - regular 

addbib - create or 

getfd - get the file descriptor of an 

strings, xstr- 

recovery. 

ioinit - change 
telese, tread, twrite, trewin, tskipf, tstate - 

functions. 

signal - simplified software signal 

sigvec - software signal 

arithmetic - provide drill in number 

pstat - print system 

true, 

inet - Internet protocol 

without checking the disks. 

the disks, fastboot, 

abort - generate a 

trpfpe, fpecat - trap and repair floating point 

chmod, 
chown. 



ecvt, 

fopen, f reopen, 

ferror, 

inquiries. 

base subroutines, dbminit, 

head - display first 

fclose, 

bcopy, bcmp, biero, 

getc, 
stream, getc, get char. 



execute a subroutine after a specified time alarm(3F) 

execute a UNIX command 8y8tem(3F) 

execute command repeatedly c8h(l) 

execute commands at a later time at(l) 

executed in reverse order. la8tcomm(l) 

execution uux(lC) 

execution accounting file acct(5) 

execution for an intenral sleep(l) 

execution for an interval 8leep(3F) 

execution for interval sleep(3) 

execution profile monitor(3) 

execution profiler pxp(l) 

execution server. rexecd(8C) 

execution time profile profil(2) 

executor pix(l) 

execv, execle, execlp, cxecvp, environ - execute a . . . . execl(3) 

execve - execute a file execve(2) 

execvp, environ - execute a file execl(3) 

existing file link(3P) 

existing file system tunefs(8) 

_exit - terminate a process exit(2) 

exit - terminate a process after flushing any exit(3) 

exit - terminate process with status exit(3F) 

exit, export, login, newgrp, read, readonly, set,/ .... 8h(l) 

exit from switch C8h(l) 

exit: leave shell. C8h(l) 

exit while/foreach loop csh(l) 

exp, tog, loglO, pow, sqrt - exponential exp(3M) 

expand argument list C8h(l) 

expand tabs to spaces, and vice versa expand(l) 

expand, unexpand - expand tabs to spaces, and vice . . expand(l) 

experimental Ethernet interface en(4S) 

expire - remove outdated news articles expire(8) 

exploration game adventure(6) 

exponent. ..,...«... frexp(3) 

exponential, logarithm, power, square root exp(3M) 

export, login, newgrp, read, readonly, set, shift,/ .... sh(l) 

expr - evaluate arguments as an expression expr(l) 

expression. expr(l) 

expression handler. ^ . . . regex(3) 

extend bibliographic database addbib(l) 

external unit number getfd(3F) 

extract strings from C programs to implement shared . . xstr(l) 

eyacc - modified yacc allowing much improved error . . eyacc(l) 

f77 - FORTRAN-?? compiler. f77(l) 

f7? I/O initialisation ioinit(3F) 

f?? tape I/O. topen, topen(3F) 

fabs, floor, ceil - absolute value, floor, ceiling fioor(3M) 

facilities. signal(3) 

facilities. sigvec(2) 

facts arithmetic(6) 

facts p8tat(8) 

false ~ provide truth values. . true(l) 

false, true - provide truth values fal9e(l) 

family. ........ ^ ,. .~ inet(4F) 

fastboot, fasthalt - reboot/halt the system fa8tboot(8) 

fasthalt - reboot/halt the system without checking . . . fastboot(8) 

fault abort(3) 

faults. trpfpe(3F) 

fbio - general properties of frame buffers. ....... fbio(4S) 

fchmod - change mode of file. chmod(2) 

fchown ~ change owner and group of a file chown(2) 

fclose, flflush - close or flush a stream. fclo8e(3S) 

fcntl - file control. fcntl(2) 

fcnti - file control options fcntl(5) 

fcvt, gcvt - output conversion ecvt(3) 

fdopen - open a stream fopen(3S) 

feof, clearerr, fileno - stream status inquiries ferror(3S) 

ferror, feof, clearerr, fileno - stream status ferror(3S) 

fetch, store, delete, firstkey, nextkey - data dbm(3X) 

few lines of specified files head(l) 

Slush - close or flush a stream fcio8e(3S) 

ffs - bit and byte string operations. bstring(3) 

fg: bring job into foreground C8h(l) 

fgetc - get a character from a logical unit getc(3F) 

fgetc, getw - get character or integer from getc(3S) 
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get", 

grep, egrep, 

access - determine accessibilitj of 

access - detennine accessability of a 

acct - execation acconnting 

chmod, fchmod - change mode of 

chmod - change mode of a 

chown, fchown - change owner and gronp of a 

coirm - remove columns from a 

core - format of memory image 

creat - create a new 

source: read commands from 

ctags - create a tags 

dd - convert and copy a 

delta - make a delta (change) to an SCCS 

execv, execle, execlp, execvp, environ - execute a 

execve - execute a 

- apply or remove an advisoiy lock on an open 

fpr - print Fortran 

get - get a venion of an SCCS 

group - group 

link - make a hard link to a 

link, symink - make a link to an existing 

mkdir - make a directory 

mknod - make a special 

mknod - build special 

more, page - browse through a text 

- rebuild the data base for the mail aliues 

open a file for reading or writing, or create a new 

passwd - pusword 

prs - print an SCCS 

remote ~ remote host description 

rename - change the name of a 

rename - rename a 

rev - revene lines of a 

rmdei - remove a delta from an SCCS 

nadir - remove a directory 

sccsdiff - compare two versions of an SCCS 

sccsfile - format of SCCS 

site - siie of an object 

printable strings in an object, or other binary, 

sum - sum and count blocks in a 

symlink - make symbolic link to a 

tail - display the last part of a 

tmpnam - create a name for a temporary 

touch - update date last modified of a 

unget - undo a previous get of an SCCS 

uniq - report repeated lines in a 

uuencode - format of an encoded uuencode 

val - validate SCCS 

vipw - edit the password 

vswap - convert a foreign font 

write, writev - write on a 

diff - differential 

cpio - copy 

mkstr - create an error message 

diffS - 3-way differential 

fcnti - 

f cntl - 

rep - remote 

nmask: change or display 

umask - set 

getfd - get the 

sact - print current SCCS 

setfsent, endfsent - get file system descriptor 

getgrgid, getgmam, setgrent, endgrent - get group 

getpwnam, setpwent, endpwent - get password 

grep, egrep, fgrep ~ search a 

open - open a 

newsrc - information 

aliases - aliases 

aaencode,uudecode - encode/decode a binary 

ar - archive (library) 

tar - tape archive 

which ~ locate a program 



fgets - get a string from a stream gets(SS) 

fgrep - search a file for a pattern grep(l) 



exed, 



»cces8(2) 

acce88(3F) 

acct(5) 

chmod(2) 

chmod(SF) 

chown(2) 

colrmfl) 

core(5j 

creat(2) 

csh(l) 

ctag8(l) 

dd(l) 

delta/l) 

cxecl(3) 

execve(2) 

lock fiock(2) 

fpifl) 

fct(l) 

«rottl>(5) 

Iink(2) 

Iink(3F) 

mkdii<2) 

mknodf2) 

mknod(8) 

more(l) 

newaliaies newalia8es(8) 

open - open(2) 

passwd(5) 

Pn(l) 

remote(5) 

rename(2) 

rename(3F) 

. . . «v(l) 

rmdeljl) 

rmdir(2) 

sccsdiS(l) 

8CC8file(5) 

■•««(1) 

strings - find tring8(l) 

sum(l) 

. symiink(2) 

tail(l) 

tmpnam(3C) 

touchfl) 

unget(l) 

ttaiq(l) 

uuencode(5) 

Ml) 

▼»Pw(8) 

vswap(l) 

write(2) 

filed) 

difi(l) 



- determine file type 

and directory comparator 

archives in and out cpio(i) 

by massaging C source mkstr(l) 

comparison diff3(l) 

control fcntU2) 

control options fcntl(5) 

copy rcp(lC) 

creation mask csh(l) 

creation mode mask . uma8k(2) 

descriptor of an external unit number. getfd(3F) 

editing activity. sact(l) 

e entry, /getfsspec, getfsfile, getfstype, getfsent(3) 

e entry, getgrent gctgrent(3) 

e entry, getpwent, getpwuid, getpwent(3) 

e for a pattern, grep(l) 

e for reading or writing, or create a new file. ..... open(2) 

e for readnew8(l) and checknews(l) new8rc(5) 

e for sendmail alia8e8(5) 

e for transmission via mail nuencode(lC) 

e format ai(5) 

e format tar(5) 

e including aliases and paths (csh only) which(l) 
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fsplit - split a multi-roatine Foitnn 

split - split & 

pmeiige - pasc&l 

mktemp - make a aniqae 

fseek, fteli - reposition a 

stat, Istat, fstat - get 

mkfs - construct a 

mkproto - construct a prototype 

meant, umoant - moant or remove 

meant, amoant - meant and dismount 

newfs - constract a new 

seiqaota - enable/disable quotas on a 

tunefs - tune ap an existins 

repair, fsck - 

getfs£le, getfstype, setfsent, endfsent - get 

dcheck - 

damp - incremental 

hier- 

dumpfs - dump 

qaot - sommariie 

restore - incremental 

icheck - 

mtab - mounted 

fs, inode - format of 

df - report free disk space on 

atime - set 

utimes - set 

uusend - send a 

troneate, ftruncate - truncate a 

ftp- 

ftpd - DARPA Internet 

tftpd - DARPA Trivial 

file - determine 

editor, vi - view a 

baaename - strip 

glob: 

f error, feof, clearerr, 

admli - create and administer SCCS 

checknr - check nroff/troff 

cmp - compare two 

comm - select or reject lines common to two sorted 

config - baild system configuration 

cp - copy 

find ~ find 

split a mutti-roatine Fortran file into individual 

bead - display first few lines of specified 

install - install 

MAKEDBV - make system special 

mv - move or rename 

aewa - USENET network news article, utility 

rmdir, rm - remove (unlink) directories or 

sort - sort or merge 

tee - copy standard output to many 

what - identify the version of 

compact, ancompact, ccat - compress and uncompress 

iatro - introduction to special 

eatman - create the cat 

fsync - synchronise a 

rm, rmdir - remove (unlink) 

pr - print 

sticky - executable 

fstab - static information about the 

colcrt - 

col- 

plot - graphics 

refer - 

find - 

look - 

man -- print out manual pages; 

ttyname, isatty, ttyslot - 

ttynam, isatty - 

lorder - 

binary, file, strings - 

Inverted index to a bibliography .br iookbib - 

spell, spellin, spellout - 



file into individual files f8plit(l) 

file into pieces 8plit(l) 

file merger. pmerge(l) 

file name mktemp(3) 

file on a logical unit fseek(3P) 

file status 8tat(2) 

file system mkfs(8) 



file system, 
file system, 
file system, 
file system, 
file system. 



mkproto(8) 

mount(2) 

moant(8) 

newfs(8) 

3etquota(2) 



file system tanefs(8) 

file system consistency check and interactive fsck(8) 

file system descriptor file entry, /getfsspec getfsent(3) 

file system directory consistency check dcheck(8) 

file system damp damp(8) 

file system hierarchy. hier(7) 

file system information dampfs(8) 

file system ownership quot(8) 

file system restore re8tore(8) 

file system storage consistency check icheck(8) 

file system table mtab(5) 

file system volume. fs(5) 

file systems. df(l) 

file times utime(3C) 

file times. atimes(2) 

file to a remote host. nasend(lC) 

file to a specified length truncate(2) 

file transfer program ftp(lC) 

File Transfer Protocol server ftpd(8C) 

File Transfer Protocol server tftpd(8C) 

file type fil^l) 

file without changing it using the vi visual view(l) 

filename affixes. basename(l) 

filename expand argument list C8h(l) 

fileno - stream status inquiries ferTor(3S) 

files admin(l) 

files checknr(l) 

files. cmp(l) 

files comm(l) 

fila config(8) 

files cp(l) 

files. find(l) 

files, fsplit- f8plit(l) 

files head(l) 

files in8tall(l) 

files makedev(8) 

files mv(l) 

filet new8(5) 

files rmdir(l) 

files sort(l) 

files. tee(l) 

files. what(l) 

files, and cat them. compact(l) 

files and hardware support intro(4) 

files for the manuaJ catman(8) 

file's in-core state with that on disk fsync(2) 

files or directories rm(l) 

file(s), possibly in multiple columns pr(l) 

files with persistent text 8ticky(8) 

filesystems. fstab(5) 

filter nroff output for CRT previewing colcrt(l) 

filter reverse paper motions col(l) 

filters p!ot(lG) 

find - find files. £nd(l) 

find and insert literature references in documents. . . . refer(l) 

find files £nd(l) 

find lines in a sorted list look(l) 

find manual information by keywords. ........ man(l) 

find name of a terminal ttyname(3) 

find name of a terminal port ttynam(3F) 

find ordering relation for an object libraiy !order(l) 

find printable strings in an object, or other 8tring8(l) 

find references in a bibliography, indxbib ~ make . . . )Didxb!b(l) 

find spelling errors spell(l) 
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fold - fold long lines for 

hf »d - display 

dbminit, fetch, store, delete, 

fish - play "Go 

values, flmin, 

extreme values. 

trpfpe, fpecut - trap and repair 

fptype - check a 

isinf, isnan - test for indeterminate 

open file. 

functions, fabs, 

fabs, floor, ceil - absolute value, 

fclose. Slush - close or 

flush - 

exit - terminate a process after 

device. 

fold - 

vBwap - convert a foreign 

vf ont - 

break: exit while/ 

fg: bring job into 
vswap - convert a 



idate, itime - return date or time in numerical 

dmesg - collect system diagnostic messages to 

ar - archive (library) file 

dump, dumpdates - incremental dump 

tar - tape archive file 

kbd - keyboard translation table 

indent - indent and 

troff - typeset or 

htable - convert NIC standard 

gettable - get NIC 

nnencode - 

cpio - 

dir- 

fs, inode - 

core- 

sccsfile - 

tbl- 

tp - DBC/mag tape 

vfont - font 

scanf, fscanf , sscanf - 

printf , fprintf , sprintf - 

fmt - simple text 

nroff - text 

m> - text 

me - macros for 

ratfor - rational 

fpr - print 

fsplit - split a multi-routine 

intro - introduction to 

putc, fputc -- write a character to a 

f77- 

adage. 

trpfpe, 

printf, 

unit, putc, 

putc, putchar, 

puts, 

bw - Sun black and white 

fbio - general properties of 

df - report 

allocator, malloc, 

fopen, 

exponent. 

from - who is my mail 



finite width output device fold(l) 

first few lines of specified files head(l) 

firstkey, noctkey - data base subroutines dbm(3X) 

Fish" fi8h(6) 

fish - play "Go Fish" fish(6) 

flmax, dflmin, dflmax, inmax - return extreme range(3F) 

flmin, flmax, dflmin, dflmax, inmax - return range(3F) 

floating point faults trpfpe(3F) 

floating point number. fptyp^3F) 

floating point values isinf(3) 

flock - apply or remove an advisory lock on an flock(2) 

floor, ceil - absolute value, floor, ceiling floorf3M) 

floor, ceiling functions. floor(3M) 

flush - flush output to a logicd unit flush(3F) 

flush a stream fclose(3S) 

flush output to a logical unit flush(3F) 

flushing any pending output exit(3) 

fmt - simple text formatter. fmt(l) 

fold - fold long lines for finite width output fold(l) 

fold long lines for finite width output device fold(l) 

font file vswap(l) 

font formats. vfont(5) 

fopea, freopen, fdopea - open a stream fopen(3S) 

foreach loop cshflV 

foreach: loop over list of names cshfl) 

foreground csh(l) 

foreign font file vswap(l) 

fork - create a copy of this process forkfSF) 

fork - create a new process fork(2) 

form idate(3F) 

form error log dmesg(8) 

format ar(5) 

format dump(5) 

format ^u^S) 

format and default table . kbd(5) 

format C program source indent(l) 

format documents. . troff(l) 

format host tables htable(8) 

format host tables from a host gettable(8C) 

format of an encoded uuencode file auencode(5) 

format of cpio archive. cpio(5) 

format of directories dir(5) 

format of file system volume fs(S) 

format of memoiy image file core(5) 

format of SCCS file. . scc8file(5) 

format tables for nroff or troff. tbl(l) 

formats tp(5) 

formats vfont(5) 

formatted input conversion scanf(3S) 

formatted output conversion printf(3S) 

formatter fmt(l) 

formatting and typesetting nroff(l) 

formatting macros msf7) 

formatting papers. me(7) 

Fortran dialect ratfor(l) 

Fortran file. fp^l) 

Fortran file into individaal files fsplit(l) 

FORTRAN library functions intro(3F) 

FORTRAN logical unit putc(3F) 

FORTRAN-77 compiler. f77(l) 

fortune - print a random, hopefully interesting, .... foitnne(6) 

fpecnt - trap and repair floating point faults. trpfpe(3F) 

fpr - print Fortran file. fpr(l) 

fprintf, sprintf - formatted output conversion printf(3S) 

fptype - check a floating point number fptype(3F) 

fputc - write a character to a FORTRAN logical .... putc(3F) 

fputc, putw - put character or word on a stream. . . . putc(3S) 

fpnts - put a string on a stream put8(3S) 

frame buffer bw(4S) 

frame buffen fbio(4S) 

fread, fwrite - buffered binary input/output. fread(3S) 

free disk space on file systems. . df(l) 

free, realloc, calloc, cfree, alloca - memory malloc(3) 

freopen, fdopen - open a stream fopen(3S) 

frexp, Idexp, modf - split into mantissa and frexp(3) 

from?. from(l) 
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8CC8- 

sc&nf, 

interactive repair. 

u&it. 

individual files. 

Stat, Istat, 

that OS disk. 

fseek, 

fseek, 

time, 

server. 

truncate, 

shtttdowB - shot down part of a 

gamma - log gamma 

fabs, floor, ceil - absolnte value, floor, ceiling 

intro - introduction to library 

intro - introduction to compatibility library 

intro - introduction to FORTRAN library 

intro - introduction to mathematical library 

intro - introduction to network library 

jo, jl, jn, yO, yl, yn - bessel 

cos, tan, asin, acos, atan, atan2 - trigonometric 

sinh, cosh, tanh - hyperbolic 

curses - screen 

fread, 

adventure - an exploration 

monop - Monopoly 

snake, snscore - display chase 

trek ~ trekkie 

worm - Play the growing worm 

canfield, cfscores - the solitaire card 

cribbage ~ the card 

hangman - Computer version of the 

backgammon -the 

boggle - play the 

wump - the 

gamma ~ log 
item, madd, msub, mult, mdiv, min, mout, pow, 

ecvt, fcvt, 

buffers, kgmon - 

abort- 

adbgen - 

makekey - 

ncheck - 

rand, srand - random number 

lex- 

/initstate, setstate - better random number 

random number generator, routines for changing 

dkio - 
perror. 



integer from stream. 

from stream, getc, 

directoiy. 



getgid. 



getuid, 

unit number. 

setfsent, endfsent - get file system descriptor/ 

file system descriptor file/ getfsent, getfsspec. 

- get file system descriptor file/ getfsent, 

descriptor file/ getfsent, getfsspec, getfsfile, 

getuid, 

get group file entry, 
file entry, getgrent, 



front end for the .SM SCCS subsystem sccs(l) 

fs, inode - format of file system volume , . . . fs(5) 

fscanf, sscanf - formatted input conversion. ..... 3canf(3S) 

fsck - file system consistency check and fsck(8) 

fseek, ftell - reposition a file on a logical fseek(3F) 

fseek, ftell, rewind - reposition a stream fseek(3S) 

fsplit - split a multi-routine Fortran file into fsplit(l) 

fstab - static information about the filesystems fstab(5) 

fstat - get file status stat(2) 

fsync - synchronize a file's in-core state with fsync(2) 

ftell ~ reposition a file on a logical unit f8eek(3F) 

ftell, rewind - reposition a stream fseek(3S) 

ftime - get date and time time(3C) 

ftp - file transfer program ftp(lC) 

ftpd - DARPA Internet File Transfer Protocol ftpd(8C) 

ftruncate - truncate a file to a specified length truncate(2) 

full-duplex connection shutdown(2) 

function gamma(3M) 

functions. floor(3M) 

functions intro(3) 

functions introf3C) 

functions intro(3F) 

functions intro(3M) 

functions intro(3N) 

functions jO(3M) 

functions, sin, . 8i&(3M) 

functions. sinh(3M) 

functions with "optimal" cursor motion curses(3X) 

fwrite - buffered binary input/output fread(3S) 

game adventure(6) 

game monop(6) 

game 8nake(6) 

game trek(6) 

game. wonD(6) 

game canfield canfield(6) 

game cribbage cribbage(6) 

game hangman hangman(6) 

game of backgammon. backgammon(6) 

game of boggle boggle(6) 

game of hunt-the-wnmpus wump(6) 

gamma - log gamma function gamma(3M) 

gamma function , gamma(3M) 

gcd, rpow - multiple precision integer arithmetic mp(3X) 

gcore - get core images of running processes gcore(l) 

gcvt - output convenion ecvt(3) 

generate a dump of the operating system's profile . . . kgmon(8) 

generate a fault abort(3) 

generate adb script adbgen(8) 

generate encryption key. makekey(8) 

generate names from i-numbers ncheck(8) 

generator. rand(3C) 

generator of lexical analysis programs lex(l) 

generator; routines for changing generators. random(3) 

generators, /srandom, initstate, setstate - better . . . random(3) 

generic disk control operations dkio(4S) 

gerror, iermo - get system error messages. ....... perror(3F) 

getarg, iargc - return command line arguments getarg(3F) 

getc, fgetc - get a character from a logical unit. .... getcf3F) 

getc, getchar, fgetc, getw - get character or getc(3S) 

getchar, fgetc, getw - get character or integer getc(3S) 

getcwd - get pathname of current working getcwd(3F) 

getdate - convert time and date from ASCII getdate(3) 

getdtablesise - get descriptor table size. getdtable8ize(2) 

getegid - get group identity getgid(2) 

getenv - get value of environment variables. ...... getenv(3F) 

getenv - value for environment name gete&v(3) 

geteuid - get user identity getaid(2) 

getfd - get the file descriptor of an externaJ getfd(3F) 

getfsent, getfsspec, getfsfile, getfstype getfsent(3) 

getfsfile, getfstypej setfsent, endfsent - get getf3ent(3) 

getfsspec, getfsfile, getfstype, setfsent, endfsent ..... getfseat(3) 

getfstype, setfsent, eadfsent - get file system ...... getfsent(3) 

getgid - get user or group ID of the caller. ....... getnid(3F) 

getgid, getegid - get group identity getgid(2) 

getgrent, getgrgid, getgrnam, setgrent, eadgrent - ... getgrent(3) 

getgrgid, getgrnam, setgrent, endgrent - get group . . . getgrent(3) 
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entry, getgrent, getgrgid, 

endhostent - get network host entiy. gethostent, 
network host entiy. gethostent, gethostbyaddr, 
sethostent, endhostent - get network host entry. 

host, 
timer. 



get network entry, getnetent, 

entry, getnetent, getnetby&ddr, 

endnetent - get network entry. 

aigv. 



getpid, 

scheduling priority. 

protocol entiy. getprotoent, getprotobynnmber, 

endprotoent - get protocol entry, getprotoent, 

setprotoent, endprotoent - get protocol entry. 

get password file entry. 

entry, getpwent, getpwuid, 

pusword file entiy. getpwent, 

resource consumption. 

utilisation. 

service entiy getservent, getservbyport, 

endservent - get service entry, getservent, 

setservent, endservent - get service entry. 

sockets. 

time. 



caller 
getc, getchar, fgetc, 

vadvise - 
shutdown - close down the system at a 

and time to ASCII, ctime, localtime, 

fish - play " 

setjmp, longjmp - non-local 



graph - draw a 

gprof - display call 

perfmon - 

gxtest - stand alone test for the Sun video 

colordemos - demonstrate Sun Color 

draw - interactive 

plot- 

cg - Sun color 

arc, move, cont, point, linemod, space, closepl - 

plot - 

vgrind - 

chgrp - change 

getpgrp - get process 

killpg - send signal to a process 

setpgrp - set process 

getgroups - get 

initgroups - initialise 

setgroups - set 

group - 

getgrgid, getgmam, setgrent, endgrent - get 



getgrnam, setgrent, endgrent - get group file getgrent(3) 

getgroups - get group access list getgroups(2) 

gethostbyaddr, gethostbyname, sethostent, gethostent(3N) 

gethostbyname, sethostent, endhostent - get gethostent(3N) 

gethostent, gethostbyaddr, gethostbyname gethostent(3N) 

gethostid - get unique identifier of current host getho8tid(2) 

gethostname, sethostname - get/set name of current . . getho8tname(2) 

getitimer, setitimer - get/ set value of interval getitimei(2) 

getlog - get user's login name getlog(3F) 

getlogin - get login name getlogin(3) 

getnetbyaddr, getnetbyname, setnetent, endnetent - . . getnetent(3N) 

getnetbyname, setnetent, endnetent - get network . . . getnetent(3N) 

getnetent, getnetbyaddr, getnetbyname, setnetent, . . . getnetent(3N) 

getopt, optarg, optind - get option letter from getopt(3C) 

getpagesise - get system page sise getpage8ise(2) 

getpass - read a password getpa88(3) 

getpeemame - get name of connected peer. getpeemame(2) 

getpgrp - get process group 8etpgrp(2) 

getpid - get process id getpid(3F) 

getpid, getppid - get process identification getpid(2) 

getppid - get process identification getpid(2) 

getpriority, setpriority - get/set program getpriority(2) 

getprotobyname, setprotoent, endprotoent - get .... getpn>toentf3N) 

getprotobynnmber, getprotobyname, setprotoent, . . . getprotoent(3N) 

getprotoent, getprotobynnmber, getprotobyname, . . . getprotoent(3N) 

getpw - get name from uid getpw(3) 

getpwent, getpwuid, getpwnam, setpwent, endpwent - . getpwent(3) 

getpwnam, setpwent, endpwent - get password file ... getpwent(3) 

getpwuid, getpwnam, setpwent, endpwent - get .... getpwent(3) 

getrlimit, setrlimit - control maximum system getrlimit(2) 

getrusage - get information about resource getru8age(2) 

gets, fgets - get a string from a stream. get8(3S) 

getservbyname, setservent, endservent - get get8ervent(3N) 

getservbyport, getservbyname, setservent getservent(3N) 

getservent, getservbyport, getservbyname. get8ervent(3N) 

getsockname - get socket name get80ckname(2) 

getsockopt, setsockopt - get and set options on .... get8ockopt(2) 

gettable - get NIC format host tables from a host . . . gettabIe(8C) 

gettimeofday, settimeofday - get/set date and gettimeofday(2) 

getty - set terminal mode getty(8) 

gettytab - terminal configuration data base gettytab(5) 

getuid, geteuid - get user identity. getuid(2) 

getuid, getgid - get user or group ID of the getuid(3F) 

getw - get character or integer from stream getc(3S) 

getwd - get current working directoiy pathname. . . . getwd(3) 

give advice to paging system vadvi8e(2) 

given time shutdown(8) 

glob: filename expand argument list c8h(l) 

gmtime, asctime, timesone, dysise - convert date . . . ctime(3) 

Go Fish" fi8h(6) 

goto. . . ^ setjmp(3) 

goto: command transfer. C8h(l) 

gprof - display call graph profile data gprof(l) 

graph graph(lG) 

graph - draw a graph graph(lG) 

graph profile data. gprof(l) 

graphical display of general system statistics peifmon(l) 

graphics board. gxte8t(88) 

Graphics Display colordemos(6) 

graphics drawing. draw(6) 

graphics filters plot(lG) 

graphics interface cg(4S) 

graphics interface, /erase, label, line, circle plot(3X) 

graphics interface plot(5) 

grep, egrep, fgrep - search a file for a pattern gi«p(l) 

grind nice listings of programs vgrind(l) 

group chgrp(l) 

group getpgrp(2) 

gro^ttp killpg(2) 

group setpgrp(2) 

group - group file gn>up(5) 

group access list getgroup8(2) 

group access list initgroup8(3) 

group access list setgroup8(2) 

group file group(5) 

group file entry, getgrent getgrent(3) 
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setregid - set real and effective group ID 8etregid(2) 

aetniid, aetgid, setegid, setigid - set aser and group ID. aetnid, seteaid 8etaid(3) 

getnid, getgid - get user or group ID of the caller getuid(3F) 

getgid, getegid - get group identity getgid(2) 

groups - show group memberships groups(l) 

chowa, fchown - change owner and group of a file chown(2) 

make - maintain program groups make(l) 

groups - show group memberships group8(l) 

worm - Flay the growing worm game worm(6) 

stty, gtty - set and get terminal state 8tty(3C) 

graphics board, gxtest - stand alone test for the Sun video gxte8t(88) 

halt - stop the processor. halt(8) 

stop: halt a job or process csh(l) 

reboot - reboot system or halt processor reboot(2) 

fastboot, fasthalt - reboot/ halt the system without checking the disks fastboot(8) 

rmail - handle remote mail received via nucp nnail(8) 

re_comp, rejexec - regular expression handler. regex(3) 

hangman - Computer version of the game hangman. . hangman(6) 

hangman - Computer version of the game hangman. . . hangman(6) 

vhangup - virtually " hangup" the current control terminal vhangup(2) 

nohup: run command immune to hangups csh(l) 

crash - what happens when the system crashes cra8h(8s) 

link - make a hard link to a file. Iink(2) 

intro - introduction to special files and hardware support. intro(4) 

uptime - show how long system has been up uptime(l) 

checknews - check if user has news on the USENET news network checknew8(l) 

rehash: recompute command hash table C8h(l) 

unhash: discard command hash table csh(l) 

hashstat: print command hashing statistics csh(l) 

hashstat: print command hashing statistics c8h(l) 

leave - remind you when you have to leave leave(l) 

help - ask for help. . help(l) 

help - ask for help help(l) 

od - octal, decimal, hex, ascii dump. od(l) 

hier - file system hierarchy hier(7) 

hier - file system hierarchy hier(7) 

histoiy: print history event list C8h(l) 

history: print history event list csh(l) 

fortune ~ print a random, hopefully interesting, adage fortune(6) 

gethostid - get unique identifier of current host. . getho8tid(2) 

getbostname, setbostname - get/set name of current host getho8tname(2) 

bostnm - get name of current host hostnm(3F) 

rdate - set system date from a remote host rdate(8) 

uusend - send a file to a remote host uu8end(lC) 

gettable - get NIC format host tables from a host gettable(8C) 

bto&s, Btobl, ntobi - convert values between best and network byte order, htonl. byteorder(3N) 

remote - remote best description file remote(5) 

setbostent, endbostent - get network host entry, /gethostbyaddr, gethostbyname getho8tent(3N) 

hosts - host name data base hosts(5) 

phones - remote host phone number data base phones(5) 

ruptime - show host status of local machines. ruptime(lC) 

hostid - print identifier of current host system. hostid(l) 

hostname - set or print name of current host system. . ho8tname(l) 

btable - convert NIC standard format host tables. htable(8) 

gettable - get NIC format host tables from a host . gettable(8C) 

hostid - print identifier of current host system ho8tid(l) 

system, hostname - set or print name of current host bostname(l) 

bostnm - get name of current host ho8tnm(3P) 

hosts - host name data base. . bo8ts(5) 

uptime - show how long system has been up uptime(l) 

btable - convert NIC standard format host tables. . . . btable(8) 

between host and network byte order, htonl, htons, ntobI, ntobs - convert values byteorder(3N) 

and network byte order, htonl, htons, ntohl, ntobs - convert values between host . . . byteorder(3N) 

wnmp - the game of bunt-tbe^wumpus. wump(6) 

sinb, cosh, tanb - hyperbolic functions sinh(3M) 

hypot, cabs - Euclidean distance. . hypot(3M) 

getarg, iaigc - return command line arguments getarg(3F) 

icheck - file system storage consistency check icheck(8) 

icmp - Internet Control Message Protocol icmp(4P) 

getpid - get process id getpid(3F) 

setregid - set real and effective group ID 8etregid(2) 

setgid, setegid, setigid - set user and group ID. setuid, seteuid, setruid, setuid(3) 

getuid, getgid - get user or group ID of the caller. getuid(3F} 

sa - substitute user id temporarily. sa(l) 

form, idate, itime - returs date or time in numerical idate(3F) 

getpid, getppid - get process identification. . , getpid(2) 
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gethostid - get aniqne 

hostid - print 

wh»t- 

getgid, getegid - get group 

getaid, getenid - get user 

•etreaid - set reaJ and effective naer 

perror, gerror, 



checknews - check 
exit, export, login, newgrp, read,/ tb, for, cue, 

interface, vp - 

abort - terminate abniptly with memory 

core - format of memory 

gcore - get core 

notify: request 

nohvp: ran command 

xstr - extract strings from C programs to 

eyacc - modified yacc allowing mncb 

ar - Archive 1/4 

tm - tapemaster 1/2 

which - locate a program file 

damp, dnmpdates - 

dnmp- 

restort - 

indent - 

tgetflag, tgetstr, tgoto, tpnts - terminal 

isiol, isnan - test for 

ptx - permuted 

stracat, stircmp, stmcmp, strcpy, stmcpy, strlen, 

objects, 
references in a/ indxbib - make inverted 

last- 

syscall - 

fsplit - split a mnlti-rontine Fortran file into 

.br lookbib - find references in a bibliograpjty. 

serven - 
inet^netof, inet_ntoa - Internet address/ 

address/ inet_.addr, inet_netwerk, inetjuakeaddt, 

Internet address/ inet_addr, inet_network, 

inet_>ddr, inet_network, inet^makeaddr, inetjnaof, 

inet_netof, inetjatoa - Internet/ inet_addr, 

/inetjmakeaddr, inetjnaof, inet_netof, 

dumpfs - dump file system 

pac - printer/plotter accounting 

getrusage - get 

vtimes - get 

fstab - static 

man - print out manual pages; find manual 

newsrc - 
miscellaneous - miscellaneous useful 



init - process control 

ioittit - change f77 I/O 

ttys - terminal 

initgroups - 

connect - 

popen, pclose - 

generator; routines for changing/ random, srandom, 

flmin, flmax, dflmin, dflmax, 

ciri - clear 

f>. 

read, readv - read 

soelim - eliminate .so's from nroff 

scanf, fscanf, sacanf - formatted 

ungetc - push character back into 

fread, fwiite - buffered binary 

stdio - standard buffered 

ferror, feof, clearerr, fileno - stream status 



identifier of current host. gethostid(2) 

identifier of current host system ko8tid(l) 

identify the version of files. what(l) 

identity. ^xi^d{2) 

identity. getuid(2) 

ID'S treuid(2) 

iermo - get system error messages. perror(SP) 

if - general properties of network interfaces if(4N) 

if: conditional statement csh(l) 

if user has news on the USENET news network checknew8(l) 

if, while, :, ., break, continue, cd, eval, exec, sh(l) 

ifconfig - configure network interface parameten. . . . ifGonfig(8C) 

Ikon 10071-5 Multibus Venatec parallel printer .... ▼p(4S) 

image abort(3P) 

image file. . . « core(5) 

images of running processes gcore(l) 

imemtest - stand alone memory test. imemte8t(8s) 

immediate notification csh(l) 

immune to hangups csh(l) 

implement shared strings. . X8tr(l) 

improved error recovery eyacc(l) 

inch Streaming Tape Drive ^K^S) 

inch tape drive im(4S) 

including aliases and paths (csh only) whichf 1) 

incremental dump format dump(5i 

incremental file system dump damp(8) 

incremental file system restore restore(8) 

indent - indent and format C program source. ..... indent(l) 

indent and format C program source indent(l) 

independent operation roatines. tgetent, tgetnum, . . . termcap(3X) 

indeterminate floating point values i8inf(3) 

index. ptx(l) 

index, rindex - string operations, strcat fltring(3) 

index, rindex, Inbink, ten - tell about character .... index(SP) 

index to a bibliography .br lookbib - find indxbil^l) 

indicate last logins of usen and teletypes Ia8t(l) 

indirect system call •yBcall(2) 

individual files. f8plit(l) 

indxbib - make inverted index to a bibliography .... indxbib(l) 

inet - Internet protocol family iaet(4F) 

inet server data base serversfs) 

inet.addr, inet_network, inetjmakeaddr, inetjnaof, . . inet(3N) 

inetd - internet services daemon inetd(8C) 

inetjnaof, inet_netof, inet.ntoa - Internet iad;(3N) 

inetjmakeaddr, inetjnaof, inet_netof, inet_ntoa - ... inet(3N) 

inet_netof, inetjntoa - Internet address/ inet(3N) 

inet.network, inet_makeaddr, inetjnaof, inet(3N) 

inet_ntoa - Internet address ntanipulation inet(3N) 

inews - submit news articles inew8(l) 

information. dampf8(8) 

information P»c(8) 

information about resource utilisation getni8age(2) 

information about resource utilisation vtime8f3C) 

information about the filesystems f8tab(5) 

information by keywords man(l) 

information file for readnews(l) and checknews(l). . . . newsrc^S) 

information pages intro(7) 

init - process control initialisation init(8) 

initgroups - initialise group access list initgroups(3) 

initialisation init(8) 

initialisation ioinit(3F) 

initialisation data tty8(6) 

initialise group access list. initgroups(3) 

initiate a connection on a socket. connect(2) 

initiate I/O to/from a process popen(3S) 

initstate, setstate - better random number random(3) 

inmax - return extreme values range(3F) 

•-node , clri(8) 

inode - format of file system volume fs(5) 

iapat read(2) 

«npi* 8oelim(l) 

input conversion. . 8canf(3S) 

input stream ttngetc(3S) 

input/output fread(3S) 

input/output package intro(3S) 

inquiries ferror(dS) 
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refer - find and 

insque, remqne - 

qneae. 

instjJI - 

draw - 

fsck - file system consistency check and 

fortune - print a random, hopefully 

eg - Sun color graphics 

ec - 3Com 10 Mb/s Ethernet 

eik - Sun 3 Mb/s experimental Ethernet 

lo - software toopback network 

mti - Systech MTI-800/1600 multi-terminal 

mtio - UNIX magnetic tape 

cent, point, linemod, space, closepl - graphics 

plot - graphics 

tty - general terminal 

- Ikon 10071-5 Multibus Versatec parallel printer 

Versatec printer/plotter and Centronics printer 

ifconfig - configure network 

telnet - user 

if - general properties of network 

swapon - add a swap device for 

sendmail - send mail over the 

i&el„makeaddr, inetjnaof, inet.netof, inet.ntoa - 

icmp ~ 

ftpd - DARPA 

ip- 

inet - 

inetd - 

tcp - 

udp - 

ip - Disk driver for 

spline - 

pti - phototypesetter 

px - Pascal 

pix - Pascal 

pi - Pascal 

cs& - a shell (command 

pipe - create ao 

- atomically release blocked signals and wait for 

onintr process 
sleep - suspend execution for an 
sleep - suspend execution for 
sleep - suspend execution for an 
intro ~ 
intro - 
intro - 
intro - 
int^)- 
intro- 
intro - 
intro - 
intro - 
commands, intro - 
ncheck - generate names from 
find references in a bibliography, indxbib - make 
tread, twrite, trewin, tskipf, tstate - f77 tape 
ioinit - change f77 
select - synchronous 
mem, kmem, mbmem, mbio - main memory and 

iostat - report 
popen; pclose - initiate 



Controller. 

sail - multi-user wooden ships and 

whatis - describe what a command 

isalpha, isupper, islower, isdigit, isxdigit, 

isalnum, isspace, ispunct, isprint, iscntrl,/ 

/isalnnm, isspace, ispunct, isprint, iscntrl, 

ttynam, 

ttyname, 

/isxdigit, isalnnm, isspace, ispunct, isprint, 



nsert literature references in documents refer(l) 

nsert/remove element from a queue in8que(3) 

nsque, remque - insert/remove element from a .... insque(3) 

nstall - install files in8tall(l) 

nstall files install(l) 

nteractive graphics drawing draw(6) 

nteractive repair fsck(8) 

nteresting, adage fortune(6) 

nterface cg(4S) 

nteiface ec(4S) 

nterface en(4S) 

nterface. lo(4) 

nterface mti(4S) 

nterface mtio(-4) 

nterface. /erase, label, line, circle, arc, move, plot(3X) 

nterface plot(5) 

nterface tty(4) 

nterface. vp vp(4S) 

nterface. vpc - Systech VPC-2200 vpc(4S) 

nterface parameters ifconfig(8C) 

nterface to the TELNET protocol telnet(lC) 

nterfaces if(4N) 

nterleaved paging/swapping swapon(2) 

ntemet sendmail(8) 

Internet address manipulation. /inet_network inet(3N) 

Internet Control Message Protocol icmp(4P) 

Internet File Transfer Protocol server. ftpd(8C) 

Internet Protocol ip(4P) 

Internet protocol family inet(4F) 

internet services daemon inetd(8C) 

Internet Transmission Control Protocol tcp(4P) 

Internet User Datagram Protocol udp(4P) 

Interphase 2180 SMD Disk Controller ip(4S) 

nterpolate smooth curve 8pline(lG) 

nterpreter. . pti(l) 

nterpreter. px(l) 

nterpreter and executor. P>x(l) 

nterpreter code translator. pi(l) 

nterpreter) with C-like syntax c8h(l) 

nterprocess communication channel P>pe(2) 

nterrupt. sigpause sigpau8e(2) 

ntermpts in command scripts c8h(l) 

nterval 8leep(l} 

nterval. sleep(3) 

nterval. sIeep(3F) 

ntroduction to commands intro(l) 

ntroduction to compatibility library functions intro(3C) 

ntroduction to FORTRAN libraiy functions intro(3F) 

ntroduction to libraiy functions intro(3) 

ntroduction to mathematical library functions intro(3M) 

ntroduction to network library functions intro(3N) 

ntroduction to other libraries intro(3X) 

ntroduction to special files and hardware support. . . . intro(4) 

ntroduction to system calls and error numbers intro(2} 

ntroduction to system maintenance and operation . . . intro(8) 

•numbers. ncheck(8) 

nverted index to a bibliography .br lookbib - indxbib(l) 

I/O. topen, tclose topen(3F) 

I/O initialisation ioinit(3F) 

I/O multiplexing . select(2) 

I/O space mem(4S) 

I/O statistics. . io8tat(8) 

I/O to/from a process popen(3S) 

iocti - control device ioctl(2) 

ioinit - change f77 I/O initialisation ioinit(3F) 

iostat - report I/O statistics io8tat(8) 

ip - Disk driver for Interphase 2180 SMD Disk ip(4S) 

ip - Internet Protocol ip(4P) 

iron men 8ai!(6) 

is. whati8(l) 

isalnum, isspace, ispunct, isprint, iscntrl,/ ....... ctype(3) 

isalpha, isupper, islower, isdigit, isxdigit ctype(3) 

isascii, isgraph, toupper, tolower, toascii -/ ctype(3) 

isatty - find name of a terminal port ttynam(3F) 

isatty, ttyslot - find name of a terminal ttyname(3) 

iscntrl, isascii, isgraph, toupper, tolower,/ ctype(3) 
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isprint, iscntrl,/ isalpha, isnpper, islower, 

/iasp&ce, ispanct, isprint, iscatri, isascii, 

point valnes. 

ispnnct, isprint, iscnttl,/ isalpha, isnpper, 

values, isinf, 

/isdigit, isxdigit, isainnm, isspace, ispunct, 

/islower, isdigit, iaxdigit, isainnm, isspace, 

/isnpper, islower, isdigit, isxdigit, isainnm, 

system - 

isspace, ispnnct, isprint, iscntri,/ isalpha, 

iscntrl,/ isalpha, isnpper, islower, isdigit, 

vi - view a file without changing 

idate, 

rpow - multiple precision integer arithmetic. 

suspend: suspend a shell, resuming 

JO, 

JO, jl. 

bg: place 

fg: bring 

jobs: print current 

stop: halt a 

crontab - table of times to run periodic 

kill: kill 
Iprm - remove 



default table. 

makekey - generate encryption 

table, kbd- 

print out manual pages; find manual information by 

profile bnffen. 

process. 

kill: 

chase - Tiy to escape to 

mem, 

quit - test your 

linemod, space, closepl - graphics/ openpl, erase, 

awk - pattern scanning and processing 

be - arbitrary-precision arithmetic 

set, shift, times, trap, nmask, wait - command 

cpp - the C 
order. 

frejcp, 
leave - remind you when you have to 

exit: 

index, rindex, Inblnk, 

ftruncate - truncate a file to a specified 

getopt, optarg, optind - get option 

lex - generator of 

intro - introduction to other 

ranlib - convert archives to random 

lorder - find ordering relation for an object 

ar - archive ( 

intro - introduction to 

intro - introduction to compatibility 

intro - introduction to FORTRAN 

intro - introduction to mathematical 

intro - introduction to network 

ar - archive and 

csh - a shell (command interpreter) with C- 

limit: alter per-process resource 

unlimit: remove resource 

ulimit - get and set user 

getarg, iarge -^ return command 

space, closepl - graphics/ openpl, erase, label, 

bk- 
Ipr- off 



isdigit, isxdigit, isainnm, isspace, ispnnct ctypefS) 

isgraph, toupper, tolower, toascii - character/ ctype(3) 

isinf, isnan - test for indeterminate floating i8inf(3) 

islower, isdigit, isxdigit, isainnm, isspace ctyp«(3) 

isnan - test for indeterminate floating point isinf(3) 

isprint, iscntrl, isascii, isgraph, toupper,/ ct]rpe(3) 

ispunct, isprint, iscntrl, isascii, isgraph,/ ctype(3) 

isspace, ispnnct, isprint, iscntrl, isascii,/ ctype(3) 

issue a shell command lystemfS) 

isnpper, islower, isdigit, isxdigit, isainnm ctypef3| 

isxdigit, isainnm, isspace, ispunct, isprint ctype(3) 

it using the vi visual editor view(l) 

itime - return date or time in numerical form idate(3F) 

item, madd, msnb, mult, mdiv, min, mont, pow, gcd, . . mp(3X) 

its superior. , C8h(l) 

jo, jl, jn, yO, yl, yn - bessel functions jO(3M) 

jl, jn, yO, yl, yn - bessel functions jO(3Mi 

JB. yO, yl, yn - bessel functions jO(3M) 

job in background csh(l) 

job into foreground. cshfl) 

job list. . . . ^ cshili 

job or procMs. csh(l) 

jobs crontab(5) 

jobs and processes csh(lj 

jobs from the line printer spooling queue Iprmu) 

jobs: print current job list csh(l) 

join - relational database operator. joinf 1) 

kbd - keyboard translation table format and kbd(5) 

key makekqr(8) 

keyboard translation table format and default kbd(5) 

keywords, man - man(l) 

kgmoD - generate a dump of the operating system's . . kgmon(8) 

kill - send a signal to a process killf3F) 

kill - tend a signal to a process, or terminate a ^''v) 

kill - send signal to a process kill(2i 

kill jobs and processes ; cshil i 

kill: kill jobs and processes csh(l) 

killer robots. . cha8e(6) 

killpg - send signal to a process group killpg(2) 

kmem, mbmem, mbio - main memory and I/O space. . . mem(4S) 

knowledge quii(6) 

label, line, circle, arc, move, cont, point plot(3X) 

language awk(l) 

language bcfl) 

language, /export, login, newgrp, read, readonly, . . . 8h(l) 

language preprocessor cpp(l) 

lastcomm - show last commands executed in revene . . la8tcomm(l) 

Id - link editor. ld(l) 

Idexp, modf - split into mantissa and exponent frexp(3) 

leave leave(l) 

leave - remind you when yon have to leave. leave(l) 

leave shell csh(l) 

len - tell about character objects index(3F) 

length, truncate, tnincate(2) 

letter from argv getopt(3C) 

lex - generator of lexical analysis programs '^(^) 

lexical analysis programs; lex(l) 

libraries. intro(3X) 

libraries. ranlib(l) 

library. lorder{l) 

library) file format ai(5) 

libraiy functions intro(3) 

libraiy functions intro(3C) 

library functions introfSF) 

library functions intro(3M) 

libraiy functions intro(3N) 

libraiy maintainer at^i) 

like syntax csh(l) 

limit: alter per-process resource limitations cshflj 

limitations cshil) 

limitiations C8h(l) 

limits ulimit(3C) 

line arguments. getarg(3F) 

line, circle, arc, move, cont, point, linemod plot(3X) 

line discipline for machine-machine communication. . . . bk(4) 

line print Ipiil) 
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Ipc - liae printer control program Ipc(8) 

Ipd - line printer daemon Ipd(8) 

Iprm - remove jobs from the line printer spooling qneoe Iprm(l) 

/erase, label, line, circle, arc, move, cont, point, linemod, space, closepl - graphics interface plot(3X) 

comm - select or reject lines common to two sorted files comm(l) 

fold - fold long lines for finite width output device fold(l) 

aniq - report repeated lines in a file. uniq(l) 

look - find lines in a sorted list look(l) 

rev - reverse lines of a file revfl) 

head - display first few lines of specified files head(l) 

readli&k - read valae of a symbolic link readlink(2) 

link - make a hard link to a file Iink(2) 

Id- link editor Id(l) 

a.ont - assembler and link editor ontpnt a.oat(5) 

link, symink - make a link to an existing file link(3F) 

link - make a hard link to a file Iink(2) 

symlink - make symbolic link to a file 8ymlink(2) 

link, symink - make a link to an existing file link(3P) 

In - make links In(l) 

lint - a C program verifier. . lint(l) 

glob: filename expand argnment list csh(l) 

history: print history event list C8h(l) 

jobs: print current job list csh(l) 

shift: manipulate argument list csh(l) 

getgroups - get group access list getgroaps(2) 

initgronps - initialiie group access list initgroaps(3) 

look - find lines in a sorted list look(l) 

nlist - get entries from name list nlist(3) 

nm - print name list nm(l) 

setgroups - set group access list 8etgroap8(2) 

varargs - variable argument list varargs(3) 

Is - list contents of directory l8(l) 

foreach: loop over list of names C8h(l) 

usen - compact list of users who are on the system U8ers(l) 

listen - listen for connections on a socket Iisten(2) 

listen - listen for connections on a socket Ii8ten(2) 

vgrind - grind nice listings of programs vgrind(l) 

refer - find and insert literature references in documents refer(l) 

In - make links In(l) 

index, rindex, Inbink, len - tell about character objects index(3F) 

to - software loopback network interface lo(4) 

loc - return the address of an object loc(3F) 

convert date and time to ASCII, ctime, localtime, gmtime, asctime, timezone, dysize - ctime(3) 

(csh only), which - locate a program file including aliases and paths .... which(l) 

whereis - locate source, binary, and/or manual for program. . . . wherei8(l) 

end, etext, edata - last locations in program end(3) 

flock - apply or remove an advisory lock on an open file. flock(2) 

"login", lockscreen - maintain window context until lock8creen(l) 

■ collect system diagnostic messages to form error log. dmesg . dme8g(8) 

syslog, openlog, closelos - control system log. 8ysIog(3) 

sysleg - make system log entry. 8ysIog(l) 

gamma - log gamma function gamma(3M) 

power, square root, exp, log, loglO, pow, sqrt - exponential, logarithm, exp(3M) 

syslog - log systems messages 8y8log(8) 

square root, exp, log, loglO, pow, sqrt - exponential, logarithm, power, .... exp(3M) 

exp, log, loglO, pow, sqrt - exponential, logarithm, power, square root exp(3M) 

rwho - who's logged in on local oaachines rwho(lC) 

flush - flush output to a logical unit flush(3F) 

fseek, ftell - reposition a file on a logical unit f8eek(3F) 

getc, fgetc - get a character from a logical unit getc(3F) 

putc, fputc - write a character to a FORTRAN logical unit putc(3F) 

lockscreen - maintain window context until " login" lockscreen(l) 

riogin - remote login rlogin(lC) 

login - sign on. login(l) 

ac - login accounting ac(8) 

login: login new user. csh(l) 

getlog - get user's login name getiog(3F) 

getlogin - get login name. . getlogin(3) 

login: login new user. csh(l) 

/., break, continue, cd, evaf, exec, exit, export, login, newgrp, read, readonly, set, shift, times,/ .... sh(l) 

passwd - change login password passwd(l) 

ntmp, wtmp - login records utmp(5) 

' riogind - remote login server. rlogind(8C) 

chsb - change default login shell chsh(l) 

last - indicate last logins of users and teletypes last(l) 

bsuncube - view 3-0 Sun logo. . bsancabe(6) 



Sun System Release 1.1 



January 1984 



Permuted Index 



setjmp, 

/- make inverted index to a bibliography .br 

break: exit while/foreach 

continue: cycle in 

end: terminate 

foreach: 

lo - software 

library. 



qaeae. 



•tat, 

son - is tmrrent 

Tax - is current 

bk - line discipline for machine- 

bk - line discipline for 

mptime - show host status of local 

rwho - who's loosed in on local 

m4- 

alias: shell 

toascii - charact(&i)' classification and conversion 

ms - text formattinf 

me- 

man - 

- multiple precision integer arithmetic, item, 

tp - DEC/ 

mtio - UNIX 

mt> 

rmt - remote 

mail - send and receive 

prmail - print out waiting 

recnews - receive unprocessed articles via 

recnews - receive unprocessed articles via 

sendnews -- send news articles via 

encode/decode a binary file for tiansmission via 

nurec - receive procased news articles via 

xsend, xget, enroll - secret 

/bin/ 

mailaddr - 

biff - 

newaliases - rebuild the database for the 

/bin/mail - send or receive 

from - who is my 

sendmail - send 

rmail *- handle remote 

mem, kmem, mbmem, mbio - 

mak^ - 

locksereen - 

ar - archive and library 

intro - introduction to system 

delta - 

mkdir - 

mkdir - 

link- 

link, symink - 

mknod - 

mktemp - 

- find references in a bibliography, indxbib - 

In- 

symlink - 

syslog - 

MAKEDEV - 

script - 



memory allocator. 



ogont: end session. csh(l) 

ongjmp - non-local goto >etjmp(3) 

ook - find lines in a sorted list look(l) 

ookbib - find references in a bibliography. indxbib(l) 

oop C8h(l) 

loop. ,.«..•...•••••••••••••• csh(l) 

oop • •••••••• C8h(l) 

oop over list of names. C8h(l) 

oopback network interface. lo(4) 

order - find ordering relation for an object lorderfl) 

pc - line printer control program Ipc(8) 

pd - line printer daemon. ipd(8) 

pq - spool queue examination program Ipq(l) 

pr - off line print Ipi(l) 

prm - remove jobs from the line printer spooling . . . Iprm(l) 

8 - list contents of directory Is(l) 

seek, tell - move read/write pointer. l8eek(2) 

Stat, fstat - get file status tat(2) 

m4 - macro processor. m4(l) 

machine a sun workstation 8un(l) 

machine a vax ▼»(!) 

machine communication bk(4) 

machine-machine communication bk(4) 

machines ruptime(lC) 

machines rwho(lC) 

macro processor in4(l) 

macros. C8h(l) 

macros, /isascii, isgraph, toupper, tolower ctype(3) 

macros ms(7) 

macros for formatting papers m'K'^) 

macros to typeset manual man(7) 

madd, msub, mult, mdiv, min, mout, pow, gcd, rpow . . mp(3X) 

mag tape formats. tp(5) 

magnetic tape interface mtio(4) 

magnetic tape manipulating program mt(l) 

magtape protocol module rmt(8C) 

mail mail(l) 

mail . prmail(l) 

mail. . recnews(l) 

mail. recnew8(8) 

mail. . sendnews(8) 

mail. iiueneode,uudecode uuencode(lC) 

mail uurec(8) 

mail X8end(l) 

mail - send and receive mail. mail(l) 

mail - send or receive mail among users. ....... binmail(l) 

mail addressing description mail&ddi(7) 

mail alarm. biff(l) 

mail aliases file. newaliase8(8) 

mail among users binmail(l) 

mail fromf . from(l) 

mail over the internet 8endmail(8) 

mail received via uucp rmail(8) 

mailaddr - mail addressing description mailaddi(7) 

main memory and I/O space mem(4S) 

maintain program groups make(l) 

maintain window context until "login" {ock8creen(l) 

maintainor. ai(l) 

maintenance and operation commands intro(8) 

make - maintain program groupa make(l) 

make a delta (change) to an sees file. ........ delta(l) 

make a directory mkdii(l) 

make a directory file mkdir(2) 

make a hard link to a file Iink(2) 

make a link to an existing file link(3P) 

make a special file. mknod(2) 

make a unique file name mktemp(3) 

make inverted index to a bibliography .br lookbib . . . indxbib(l) 

make links. . In(l) 

make symbolic link to a file 8ymlink(2) 

make system log entry. 8yslog(l) 

make system special files makedev(8) 

make typescript of terminal session script(l) 

MAKEDEV - make system special files makedev(8) 

makekey - generate encryption key makekey(8) 

malloc, free, realloc, calloc, cfree, alloca - malloc(3) 
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inform&tion by keywords. 

shift: 

qnot» - 

roQte - manual ly 

mt - magnetic tape 

inet_netof, inet_ctoa - Internet address 

frexp, Idexp, modf - split into 

catman - create the cat files for the 

man - macros to typeset 

whereis - locate source, binary, and/or 

man - print ont manual pages; find 

man - print out 

route - 

tee - copy standard output to 

omask: change or display file creation 

sigsetmask - set current signal 

umask - set file creation mode 

mkstr - create an error message file by 

intro - introduction to 

eqn, neqn, checkeq - typeset 

getrlimit, setrlimit - control 

viimit - control 

mem, kmem, mbmem, 

mem, kmem, 

ec - 3Com 10 

en - Sun 3 

as - 

precision integer/ itom, madd, msub, mult, 

bed - convert to antique 

space. 

groups - show group 

mmap - map pages of 

munmap - unmap pages of 

malloc, free, realloc, calloc, cfree, alloca - 

valloc - aligned 

mem, kmem, mbmem, mbio - main 

vfork - spawn new process in a virtual 

abort - terminate abruptly with 

core - format of 

vmstat - report virtual 

imemtest - stand alon« 

sail - mutti-user wooden ships and iron 

sort - sort or 

pmerge - pascal file 

mk^r - create an error 

recv, recvfrom, recvmsg - receive a 

send, sendto, sendmsg - send a 

icmp - Internet Control 

error - analyse and disperse compiler error 

mesg - permit or deny 

sys.errlisi, sys_nerr, ermo - system error 

perror, gerror, iermo - get system error 

psignal, sys^siglist - system signal 

vyslog - log systems 

dmesg - collect system diagnostic 



integer arithmetic. 



mille - play 

itom, madd, msub, mult, mdiv, 

pages. 

miscellaneous - 



C source. 



chmod - change 

getty - set terminal 

umask - set file creation 



man - macros to typeset manual man(7) 

man - print out manual pages; find manual man(l) 

manipulate argument list C8h(l) 

manipulate disk quotas quota(2) 

manipulate the routing tables route(8C) 

manipulating program mt(l) 

manipulation. /inet_makeaddr, inet_lnaof, inet(3N) 

mantissa and exponent frexp(3) 

manual catman(8) 

manual man(7) 

manual for program whereis(l) 

manual information by keywords man(l) 

manual pages; find manual information by keywords. . . man(l) 

manually manipulate the routing tables route(8C) 

many files tee(l) 

mask csh(l) 

mask. sigsetmask(2) 

mask uma9k(2) 

massaging C source mksti(l) 

mathematical library functions . intro(3M) 

mathematics eq&(l) 

maximum system resource consumption getriimit(2) 

maximum system resource consumption vlimit(3C) 

mb - Multibus. mb(4S) 

mbio - main memory and I/O space mem(4S) 

mbmem, mbio - main memoiy and I/O space mem(4S) 

Mb/s Ethernet interface ec(4S) 

Mb/s experimental Ethernet interface en(4S) 

mc68000 assembler a8(l) 

mdiv, min, mout, pow, gcd, rpow - multiple mp(3X) 

me -macros for formatting papers me(7) 

media bcd(6) 

mem, kmem, mbmem, mbio - main memoiy and I/O . . mem(4S) 

memberships. gronp8(l) 

memoiy. mmap(2) 

memoiy. munmap(2) 

memoiy allocator mailoc(3) 

memoiy allocator valloc(3) 

memoiy and I/O space mem(4S) 

memoiy efficient way vfork(2) 

memoiy image abort(3P) 

memoiy image file core(5) 

memoiy statistics. vmstat(8) 

memoiy test imemte8t(88) 

men. sail(6) 

merge files. . , 8ort(l) 

merger. . pmerge(l) 

mesg - permit or deny messages mesg(l) 

message file by massaging C source mksti^l) 

message from a socket recv(2) 

message from a socket send(2) 

Message Protocol. icmp(4P) 

messages error(l) 

messages. me8g(l) 

messages, perror perror(3) 

messages. perror(3F) 

messages p8ignai(3) 

messages syslogfS) 

messages to form error log dmesg(8) 

mille - play Mille Bomes mille(6) 

Mille Bomes. mille(6) 

min, mout, pow, gcd, rpow - multiple precision .... mp(3X) 

miscellaneous - miscellaneous useful information .... intro(7) 

miscellaneous useful information pages intro(7) 

mkdir - make a directory mkdii(l) 

mkdir - make a directoiy file mkdir(2) 

mkfs - construct a file system mkfs(8) 

mknod - build special file mknod(8) 

mknod - make a special file mknod(2) 

mkproto - construct a prototype file system mkproto(8) 

mkstr - create an error message file by massaging ... mksti(l) 

mktemp - make a unique file name mktemp(3) 

mmap - map pages of memoiy mmap(2) 

mode chmod(l) 

mode getty(8) 

mode mask umask(2) 
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chmod - dt^Bge 

chmod, fchmod - change 

frexp, Map, 

toach - update date last 

recoveiy. eyacc - 

rmt - remote magtape protocol 

monitor, monstartnp, 

execution profile. 

bdemoi - demonstrate Sun 

monop - 
profile, monitor, 

canes - screen functions with "optimal" cunor 

cot - filter reverse paper 

mount, umount - 

mount, umount - 



mtab - 
mouse- Sun 

arithmetic, itom, madd, msub, mult, mdiv, min, 
graphics/ openpl, erase, label, line, circle, arc,* 

mv- 
Iseek, tell - 

multiple precision integer arithmetic, itom, madd, 



interface, 
mti - Systech 

eyacc - modified yacc allowing 
precision integer arithmetic, itom, madd, msnb, 

mb- 

vp - Ikon 10071-5 

pr - print file(s), possibly in 

msub, mult, mdiv, min, mout, pow, gcd, rpow - 

select - synchronous I/O 

fsplit - split a 

mti - Systech MTI^800/1600 

sail - 

switch: 



from - whfli is 

getenv - value for environment 

getlog - get user's login 

getlogin - get login 

getsockname - get socket 

mktemp - make a unique file 

pwd - print working directory 

tty ~ get terming 

hosts - host 

networks - network 

protocols - protocol 

services - service 

tmpnam - create a 

getpw - get 

niist - get entries from 

nm - print 

rename - change the 

ttyname, isatty, ttyslot - find 

ttynam, isatty - find 

getpeemame - get 

gethostname, sethostname - get/set 

hostnm - get 

hostname - set or print 

bind - bind a 

foreach: loop over list of 

ncheck - generate 



eqn, 



mode of a file chmod(3F) 

mode of file chmod(2) 

modf - split into mantissa and exponent frexp(3) 

modified of a file touch(l) 

modified yacc allowing much improved error eyacc(l) 

module rmt(8C) 

moncontrol - prepare execution profile monitor(3) 

monitor, monstaitup, moncontrol ~ prepare monitor(3) 

Monochrome Bitmap Display bdemo8(6) 

monop - Monopoly game monop(6) 

Monopoly game. . monop(6) 

monstartnp, moncontrol - prepare execution monitor(3) 

more, page - browse through a text file more(l) 

motion car8e8(3X) 

motions col(l) 

mount and dismount file sjrstem moant(8) 

mount or remove file system monnt(2) 

mount, umount - mount and dismount file system. . . . mount(8) 

mount, amount - mount or remove file system mount(2) 

mounted file system table mtab(5) 

mouse monse('iS) 

mouse - Sun mouse mou8e(4S) 

mout, pow, gcd, rpow - multiple precision integer . . . mp(3X) 

move, cont, point, linemod, space, dosepl - plot(3X) 

move or rename files mv(l) 

move read/write pointer. Iseek(2) 

ms - text formatting macros m8(7) 

msub, mult, mdiv, min, mout, pow, gcd, rpow - .... mp(3X) 

mt - magnetic tape manipulating program mt(l) 

mtab - mounted file system table mtab(5) 

mti - Systech MTI-800/1600 multi-terminal mti(4S) 

MTI-800/1600 multi-terminal interface. mti(4S) 

mtio - UNIX magnetic tape interface mtio(4) 

much improved error recoveiy eyacc(l) 

mult, mdiv min, mout, pow, gcd, ipow - multiple . . . mp(3X) 

Multibus mb(4S) 

Mnltibuf Versatec paraJlel printer interface ▼p('4S) 

multiple columns. pr(l) 

multiple precision integer arithmetic, itom, madd, . . . mp(3X) 

multiplexing. select(2) 

multi-routine Fortran file into individual files f8plit(l) 

multi-terminiJ interface mti(4S) 

multi-user wooden ships and iron men 8ail(6) 

multi-way command branch. C8h(l) 

munmap - unmap pages of memory. munmap(2) 

mv - move or rename files. mv(l) 

my mail from? from(l) 

naine. getenv(3) 

name getlog(3F) 

name getlogin(3) 

name. get80ckname(2) 

name mktemp(3) 

name pwd(l) 

name tty(l) 

name data base. ho8ts(5) 

name data base. , network8(&) 

name data base. protocol8(5) 

name data base 8ervice8(5) 

name for a temporary file tmpnam(3C) 

name from uid getpw(3) 

name list. nli8t(3) 

name list nm(l) 

name of a file renarae(2) 

name of a terminal ttyname(3) 

name of a terminal port. ttynam(3F) 

name of connected peer getpeemame(2) 

name of current host getho8tname(2) 

name of current host. ho8tnm(3F) 

name of current host system. hostname(l) 

name to a socket bind(2) 

names. csh(l) 

names from i-numbers ncheck(8) 

ncheck - generate names from i-numbers ncheck(8) 

nd - network disk control nd(8C) 

nd - network disk driver. nd(4P) 

neqn, checkeq - tjrpeset mathematics. . eqn(l) 



January 1984 



Sun System Release 1.1 



Permuted Index 



- check if user h&s news on the USENET neirs 
ntohi, ntohs - convert valves between host and 

nd- 

nd - 

getnetbyname, setnetent, endnetent - get 

gethostbyname, sethostent, endhostent - get 

lo - software loopback 

ifconfig - configure 

if - general properties of 

intro - introduction to 

networks - 

news - USENET 

routing - system supporting for local 

routed - 

netstat - sh6w 

creat - create a 

- open a file for reading or writing, or create a 

newfs - construct a 

fork - create a 

vfoik - spawn 

login: login 

adduser - procedure for adding 

aliases file. 

/continue, cd, eval, exec, exit, export, login, 

news - USENET network 

expire - remove outdated 

inews - submit 

postnews - submit 

readnews - read 

sendnews - send 

uurec - receive processed 

checknews - check if user has news on the USENET 

checknews - check if user has 

checknews(l). 

dbmintt, fetch, store, delete, firstkey, 

gettable - get 

htable - convert 

vgrind - grind 
only). 



ciri - clear i- 
nice, 

setjmp, longjmp - 
notify: request immediate 

relationships of screens, adjacent screens - 
term - terminal driving tables for 
term - terminal driving tables ^or 

soelim - eliminate .so's from 

tbi ~ format tables for 

colcrt - filter 

deroff - remove 

checknr - check 

network byte order, htoni, htons, 

byte order. htonI, htons, ntohl, 

fptjrpe - check a floating point 
- get the file descriptor of an external unit 

phones - remote host phone 

arithmetic - provide drill in 

rand, srand - random 

/srandom, initstate, setstate - better random 

atof, atoi, atol - convert ASCII to 

intro - introduction to system calls and error 

ncheck - generate names from i- 

number - convert Arabic 



netstat - show network status netstat(8) 

network, checknews checknew8(l) 

network byte order. htonI, htons byteorder(3N) 

network disk control nd(8C) 

network disk driver nd(4P) 

network entry, getnetent, getnetbyaddr, getnetent(3N) 

network host entry, gethostent, gethostbyaddr gethostent(3N) 

network interface io(4) 

network interface parameters ifconfig(8C) 

network interfaces. if(4N) 

network library functions intro(3N) 

network name data base networks(5) 

network news article, utility files news(5) 

network packet routing routing(4N) 

network routing daemon routed(8C) 

network status netstat(8) 

networks - network name data base networks(5) 

new file creat(2) 

new file, open open(2) 

new file system. newf8(8) 

new process fork(2) 

new process in a virtual memory efficient way vfork(2) 

new user. . . , csh(l) 

new usen addusei(8) 

newaliases - rebuild the data base for the mail newalia9es(8) 

newfs - construct a new file system newfs(8) 

newgrp, read, readonly, set, shift, times, trap,/ sh(l) 

news - USE2NET network news article, utility files. . . . new8(5) 

news article, utility files new8(5) 

news articles expire(8) 

news articles inew8(l) 

news articles. , postnew8(l) 

news articles readnews(l) 

news articles via mail sendnew8(8) 

news articles via mail uurec(8) 

news network checkDews(l) 

news on the USENET news network checknews(l) 

newsrc - information file for readnew8(l) and new8rc(5) 

nextk^ - data base subroutines dbm(3X) 

NIC format host tables from a host gettable(8C) 

NIC standard format host tables htable(8) 

nice - set program priority nice(3C) 

nice listings of programs vgrind(l) 

nice, nohup - run a command at low priority (sh .... nice(l) 

nice: run low priority process csh(l) 

nlist - get entries from name list nli8t(3) 

nm - print name list nm(l) 

node ,.,... clri(8) 

nohup - run a command at low priority (sh only). . . . nice(l) 

nohup: run command immune to hangups c8h(l) 

non-local goto etjmp(3) 

notification. csh(l) 

notify: request immediate notification c8h(l) 

notify the window driver of the physical adjacent8creen8(l) 

nroff. term(5) 

nroff. term(5) 

nroff - text formatting and typesetting nroff(l) 

nroff input soelim(l) 

nroff or troff. , tbl(l) 

nroff output for CRT previewing colcrt(l) 

nroff, troff, tbI and eqn constructs deroff(l) 

nroff/troff files checknr(l) 

ntohl, ntohs - convert values between host and .... byteorder(3N) 

ntohs - convert values between host and network . . . byteorder(3N) 

null - data sink null(4) 

number fptype(3F) 

number, getfd getfd(3F) 

number - convert Arabic numerals to English nttmber(6) 

number data base phone8(5) 

number facts arithmetic(6) 

number generator. rand(3C) 

number generator; routines for changing generators. . . random(3) 

numbers. atof(3) 

numbers intro(2) 

numbers. ncheck(8) 

numerals to English namber(6) 



Sun System Release 1.1 



January 1984 



Permuted Index 



idate, itime - return date or time in 

twrite, trevin, tskipf, tstate - f77 tape 1/ 

loc - return the address of an 

site - sise of an 

lorder - find ordering relation for an 

atrinss - find printable strings in an 

index, rindex, Inblnk, ten - tell about character 

od- 
oct - Central Data 

acct - turn accounting on or 
login - sign 

nice, nohup - run a command at low priority (sh 

a program file including aliases and paths (csh 

create a new file. 

file, open - 

fopen> freopen, fdopen - 

flock - apply or remove an advisoiy lock on an 

closedir - directory operations. 

syslog, 

cont, point, linemod, space, closepi - graphics/ 

savecore - save a core dump of the 

kgmon - generate a dump of the 

intro - introduction to system maintenance and 

tgetstr, tgoto, tputs - terminal independent 

bcopy, bcmp, biero, ffs - bit and byte string 

telldir, seekdir, rewinddir, closedir - directory 

dkio - generic disk control 

strcpy, stmcpy, strlen, index, Jindex - string 

join - relatiakal database 

getopt, 

curses - screen functions with " 

getopt, optarg, 

getopt, optarg, optind - get 

fcnti - file control 

stty - set terminal 

getsockopt, setsockopt - get and set 

- convert values between host and network byte 
lastcomm - show last commands executed in reverse 

lorder - find 

vl - screen 

cpio - copy file archives in and 

expire - remove 

a.out - assembler and link editor 

- terminate a process after flushing any pending 

fread, fwrite - buffered binary input/ 

ecvt, fcvt, gcvt - 

printf , fprintf, sprintf - formatted 

fold - fold long lines for finite width 

colcit - filter nroff 

stdio - standard buffered input/ 

flush - flush 

tee - copy standard 

foreach: loop 

sendmail - send mail 

exec: 

chown - change 

chown, fchown - change 

quot - summarise file system 

diag - GeneraJ-purpose stand-alone utility 

stdio - standard buffered input/output 

rooting - system supporting for local network 

more, 

getpagesiie - get system 

pagesise - print system 

miscellaneous - miscellaneous useful information 

man - print out manual 

mmap - map 

{Dunmap - unmap 

swapon - specify additional device for 

drum - 

vadvise - give advice to 



numerical form. idate(3F) 

O. topen, tclose, tread topen(3F) 

object Ioc(3F) 

object file. i«e(l) 

object library lorder(l) 

object, or other binary, file tring8(i) 

objects index(3F) 

oct - Central Data octal serial card oct(4S) 

octal, decimal, hex, ascii dump od(l) 

octal serial card oct(4S) 

od - octal, decimal, hex, ascii dump od(l) 

off. acct(2) 

on login(l) 

onintr: process interrupts in command scripts c8h(l) 

only) nice(l) 

only), which - locate which(l) 

open - open a file for reading or writing, or open(2) 

open a file for reading or writing, or create a new .... open(2) 

open a stream fopen(3S) 

open file flock(2) 

opendir, readdir, telldir, seekdir, rewinddir, directory(3) 

openlog, closelog - control system log 8y8log(3) 

openpl, erase, label, line, circle, arc, move plot(3X) 

operating system savecore(8) 

operating system's profile buffers kgmon(8) 

operation commands intro(8) 

operation routines, tgetent, tgetnum, tgetflag, termcap(3X) 

operations. bstring(3) 

operations, opendir, readdir, directoiy(3) 

operations dkio(4S) 

operations, strcat, strncat, strcmp, stmcmp, string(3) 

operator join(l) 

optarg, optind - get option letter from argv getopt(3C) 

optimal" cunor motion curses(3X) 

optind - get option letter from argv. getopt(3C) 

option letter from argv getopt(3C) 

options fcnti(5) 

options stty(l) 

optidns on sockets getsockopt(2) 

order, htoni, htons, ntohl, ntohs byteoider(3N) 

order. la9tcomm(l) 

ordering relation for an object library loTder(l) 

oriented (visual) display editor based on ex vi(l) 

out cpio(l) 

outdated news articles expires) 

output. . a.out(5) 

output, exit exit(3) 

output. . fread(3S) 

output conversion. . ecvt(3) 

output conversion printf(3S) 

output device fold(l) 

output for CRT previewing. colcrt(l) 

output package intro(3S) 

output to a logical unit fln8h(3F) 

output to many files. tee(l) 

over list of names C8h(l) 

over the internet 8endmail(8) 

overlay shell with specified command. . csh(l) 

owner. chown(8) 

owner and group of a file chown(2) 

ownership. c . . . . . . . . .... . . .... . <iuot(8) 

pac - printer/plotter accounting information pM^) 

package diagfSs) 

package. intro(3S) 

packet routing routing(4N) 

page - browse through a text file more(l) 

P»ge»i»e getpage8iie(2) 

page site page8ise(l) 

piges intro(7) 

pages; find manual information by keywords man(l) 

pages of memory . mmap(2) 

pages of memory mnnmap(2) 

pagesise - print system page sise page8ise(l) 

paging and swapping 8wapon(8) 

paging device dnim(4) 

paging system vadvi8e(2) 
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ffwapon - add a swap device for interleaved 

socketpair - create a 

col - filter reverse 

me - macros for formatting 

vp - Ikon 10071-5 Multibus Veraatec 

ifconfig - configure network interface 

pc- 

pxref - 

pxp- 

pmeige - 

px- 

pix- 

pi- 



getpass - read a 

paeswd - change login 

passwd - 

vipw - edit the 

getpwuid, getpwnam, setpwent, e&dpwent - get 

getwd - get current working directory 

getcwd - get 

- locate a program file including aliases and 

grep, egrep, fgrep - search a file fpr a 

a^k - 



popen, 

getpeemame - get name of connected 

exit - tenainate a process after flushing any 

statistics. 

crontab - table of times to run 

mesg - 

ptx - 

limit: alter 

messages. 

error messages. 

sticky - executable files with 

phones - remote host 

pti - 
adjacentscreens - notify the window driver of the 

split - split a file iAto 
channel. 

bg: 

fish- 

mille - 

boggle - 

worm- 



pac - printer/ 
vpc - Systech VPC-2200 Versatec printer/ 

trpfpe, fpecnt - trap and repair floating 

erase, label, line, circle, arc, move, cont, 

fptype - check a floating 

isinf, isnan - test for indeterminate floating 

Iseek, tell - move read/write 

popd: 



ttynam, isatty - find name of a terminal 

ttytype - data base of termini types by 

pr - print file(s), 

analyse - Virtual UNIX 

itom, madd, msub, mult, mdiv, min, mout, 

root, exp, log, loglO, 

log, logic, pow, sqrt - ecponential, logarithm, 

be - arbitrary- 
mult, mdiv, min, mout, pow, gcd, rpo* - multiple 
monitor, monstartup, moncontrol - 



paging/swapping 8wapon(2) 

pair of connected sockets 80cketpair(2) 

paper motions , . . . col(l) 

papers me(7) 

parallel printer interface vp(4S) 

parameters ifconfig(8C) 

Pascal compiler pc(l) 

Pascal cross-reference program pxref(l) 

Pascal execution profiler. pxp(l) 

pascal file merger. pmerge(l) 

Pascal interpreter. px(l) 

Pascal interpreter and executor pix(l) 

Pascal interpreter code translator pi(l) 

passwd - change login password pa88wd(l) 

passwd - password file pa88wd(5) 

password getpa9s(3) 

password pa88wd(l) 

password file pa8swd(5) 

password file vipw(8) 

password file entry, getpwent getpwent(3) 

pathname getwd(3) 

pathname of current working directory getcwd(3F) 

paths (csh only), which which(l) 

pattern. grep(l) 

pattern scanning and processing language awk(l) 

pause - stop until signal pau8e(3C) 

pc - Pascal compiler pc(l) 

pclose - initiate I/O to/from a process popen(3S) 

peer. getpeername(2) 

pending output exit(3) 

perfmon - graphical display of general system perfmon(l) 

periodic jobs crontab(5) 

permit or deny messages ^ . . me8g(l) 

permuted index. ptx(l) 

per-process resource limitations C8h(l) 

perror, gerror, iermo - get system error . perror(3P) 

perror, sysjerriist, 8ys_ncrr, ermo - system perror(3) 

persistent text 8ticky(8) 

phone number data base phone8(5) 

phones - remote host phone number data base phones(5) 

phototypesetter interpreter. pti(l) 

physical relationships of screens adjacent8creen8(l) 

pi - Pascal interpreter code translator pi(l) 

pieces 8plit(l) 

pipe - create An interprocess communication pipe(2) 

pix - Pascal interpreter and executor pix(l) 

place job in background c8h(l) 

play "Go Fish". fish(6) 

play Mille Boraes mille(6) 

play the game of boggle. boggle(6) 

Play the growing worm game worm(6) 

plot - graphics filters plot(lG) 

plot - graphics interface, plot(5) 

plotter accounting information pac(8) 

plotter and Centronics printer interface vpc(4S) 

pmerge - pascal file merger pmerge(l) 

point faults. . trpfpe(3P) 

point, linemod, space, closepi - graphics/ openpl, . . . plot(3X) 

point number fptype(3F) 

point values i3inf(3) 

pointer l8eek(2) 

pop shell directory stack. C8h(l) 

popd: pop shell directory stack C8h(l) 

popen, pclose - initiate I/O to/from a process popen(3S) 

port ttynam(3F) 

port ttytype(5) 

possibly in multiple columns pr(l) 

postmortem crash analyzer analyze(8) 

postnews - submit news articles postnews(l) 

pow, gcd, rpow - multiple precision integer/ mp(3X) 

pow, sqrt - exponential, logarithm, power, square . . . exp(3M) 

power, square root, exp exp(3M) 

pr - print file(8), possibly in multiple columns pK^) 

precision arithmetic language bc(l) 

precision integer arithmetic, itom, madd, msub, .... mp(3X) 

prepare execution profile moaitor(3) 
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cpp - the C UngQ»ge 

colcrt - filter nroff oatpat for CRT 

a&get - ando a 

types - 

Ipr - off line 

foitune - 

pn- 

huhstat: 

jobi: 

i»ct - 

pr- 

fpr- 

history: 

hostid - 

burner - 

nm- 

hostnune - set or 

keywords, mui - 

priatenT - 

prmail- 

pstat - 

pagesiie - 

pwd - 

file, strings - find 



banner - print large banner on 

printcap - 

Ipc - line 

Ipd - line 

vp - Ikon 10071-5 Multibus Versatec parallel 

VPC-2200 Venatec printer/plotter and Centronics 

Iprm - remore jobs from the line 

pac- 

vpc - Systech VPC-2200 Versatec 

conversion. 

setpriority - get/set program scheduling 

nice - set program 

renice - alter 

nice: rub low 

nice, nohnp - ran a command at low 

adduser - 

reboot - UNIX bootstrapping 

nice: run low priority 

stop: halt a job or 

jexit - terminate a 

fork - create a new 

fork - create a copy of this 

kill - send a signal to a process, or terminate a 

kill - send signal to a 

kill - send a signal to a 

popen, pclose - initiate I/O to/from a 

wait - await completion of 

exit - terminate a 

init - 

getpgrp - get 

killpg - send signal to a 

setpgrp - set 

getpid - get 

getpid, getppid - get 

vfork - spawn new 

ottintr 

kill - send a signal to a 

limit: alter per- 

ps- 

times - get 

wait - wait for a 

wait, waits - wait for 

ptrace - 

exit - terminate 

Qurec - receive 

kill: kill jobs and 

gcore - get core images of running 

renice - alter priority of running 

wajt: wait for background 



preprocessor cpp(l) 

previewing colcrtfl) 

previous get of an SCCS file. vnget(l) 

primitive system data types type8(5) 

print IpKl) 

print a random, hopefully interesting, adage. fortune(6) 

print an SCCS file prs(l) 

print command hashing statistics csh(l) 

print current job list csh(l) 

print current SCCS file editing activity sact(l) 

print file(s), possibly in multiple columns pr(l) 

print Fortran file tpH}) 

print history event list csh(l) 

print identifier of current host system ko8tid(l) 

print large banner on printer banner(6) 

print name list Bm(l) 

print name of current host system hostname(l) 

print out manual pages; find manual infonnatien by . . man(l) 

print out the environment printenv(l) 

print out waiting mail prmail(l) 

print system facts pstat(8) 

print system page site. pagesise(l) 

print working directory name P«d(l) 

printable strings in an object, or other binary strings(l) 

printcap - printer capability data base. printcap(5) 

printenv - print out the environment printenv(l) 

printer banner(6) 

printer capability data base printcap(5) 

printer control program Ipc(8) 

printer daemon Ipd(8) 

printer interface. ^^S) 

printer interface, vpc- Systech vpc(4S) 

printer spooling queue Iprm(l) 

printer/plotter accounting information P&c(8) 

printer/plotter and Centronics printer interface vpc(4S) 

printf, fprintf, sprintf - formatted output printf(3S) 

priority, getpriority getpriority(2) 

priority. aice(3C) 

priority of running processes renice(8) 

priority process csh(l) 

priority (sh only) nice(l) 

prmail - print out waiting mail prmail(l) 

procedure for adding new users addu8ei:(8) 

procedures reboot(8) 

procesji cshfl) 

procesi csh(l) 

proces* cxit(2) 

process fork(2) 

process fork(3P) 

process kill(l) 

process kill(2) 

process kill(3F) 

process. popen(3S) 

process . wait(l) 

process after flushing any pending output. ....... exit(3) 

process control initialisation init(8) 

process group. . getpgrp(2) 

process group killpg(2) 

process group. setpgrp(2) 

process id getpid(3P) 

process identification getpid(2) 

process in a virtual memory efficient way vfork(2) 

process interrupts in command scripts csh(l) 

process, or terminate a process. . kill(l) 

process resource limitations csh(l) 

process status p8(l) 

process times. time8(3C) 

process to terminate wait(3F) 

process to terminate or stop wait(2) 

process trace. ptrace(2) 

process with status, exit(3F) 

processed news articles via mail uurec(8) 

processes csh(l) 

processes gcoie(l) 

processes renice(8) 

processes to complete csh(l) 
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awk - pattern scannics and 

halt - stop the 

m4 - macro 

reboot - reboot system or halt 



mottstartap, moncontrol - prepare execution 

profit - execution time 

kgmon - generate a damp of the operating system's 

gprof - display call graph 

prof - display 

pxp - Pascal execution 

end, etext, edata - last locations in 

ftp - file transfer 

Ipe - line printer control 

ipq - spool qnene examination 

mt - magnetic tape manipulating 

pxref - Pascal cross-reference 

units - conversion 

whereis - locate source, binaiy, and/or manual for 

cb-C 

only), which - locate a 

make - maintain 

nice - set 

getpriority, setpiiority - get/set 

indent - indent and format C 

assert - 

lint - a C 

lex - generator of lexical analysis 

vgrind - grind nice listings of 

xstr - extract strings from C 

fbio - general 

if - general 

arp - Address Resolution 

icmp - Internet Control Message 

ip - Internet 

tcp - Internet Transmission Control 

telnet - user interface to the TELNET 

udp - Intemet User Datagram 

getprotobyname, aetprotoent, endprotoent - get 

inet - Intemet 

rmt •!• remote magtape 

protocols - 

ftpd - DARPA Intemet File Transfer 

telnetd - DARPA TELNET 

tftpd - DARPA Trivial File Transfer 

tipt - transliterate 

mkproto - construct a 
arithmetic - 
false, true - 
true, false - 



pty- 



diag - General- 

ungetc - 

pnshd: 

puts, fputs - 

putc, putchar, fpntc, putv - 

logical unit. 

on a stream. 

stream, putc, 

pate, putchar, fputc, 



processing language awk(l) 

processor halt(8) 

processor m4(l) 

processor reboot(2) 

prof - display profile data prof(i) 

profil - execution time profile profil(2) 

profile, monitor, mo&itor(3) 

profile. profil(2) 

profile buffers kgmon(8) 

profile data gprof(l) 

profile data. . pi'of(l) 

profiler pxp(l) 

program end(3) 

program. ftp(lC) 

program. Ipc(8) 

program IpqU) 

program mt(l) 

program pxref(l) 

program anits(l) 

program. wherei8(l) 

program beautifier cb(l) 

program file including aliases and paths (csh 'which(l) 

program groups. . make(l) 

program priority , nice(3C) 

program scheduling priority getpriority(2) 

program source. iQdent(l) 

program verification assert(d) 

program verifier. lint(l) 

programs '^(0 

programs . vgrind(l) 

programs to implement shared strings X8tr(l) 

properties of frame buffers fbio('4S) 

properties of network interfaces if(4N) 

Protocol &rp(4P) 

Protocol. icmp(4P) 

Protocol ip(4P) 

Protocol tcp(4P) 

protocol telnet(lC) 

Protocol udp(4P) 

protocol entry, getprotoent, getprotobynumber, .... getprotoeat(3N) 

protocol family inet(4P) 

protocol module rmt(8C) 

protocol name data base protocols(5) 

Protocol server ftpd(8C) 

protocol server. telnetd(8C) 

Protocol server tftpd(8C) 

protocol trace. trpt(8C) 

protocols - protocol name data base protocols(5) 

prototype file system mkproto(8) 

provide drill in number facts arithmetic(6) 

provide truth values false(l) 

provide truth values tnie(l) 

prs - print an SCCS file pi^(l) 

ps - process status p8(l) 

pseudo terminal driver. pty(4) 

psignal, sysjiiglist - system signal messages psignal(3) 

pstat - print system facts p8tat(8) 

pti - phototypesetter interpreter pti(l) 

ptrace - process trace. ptrace(2) 

ptx - permuted index. ptx(l) 

pty - pseudo terminal driver pty(4) 

purpose stand-alone utility package diag(8s) 

push character back into input stream ungetc(3S) 

push shell directory stack C8h(l) 

pushd: push shell directory stack csh(l) 

put a string on a stream pat8(3S) 

put character or word on a stream putc(3S) 

putc, fputc - write a character to a FORTRAN .... putc(3F) 

putc, putchar, fputc, putw - put character or word . . . putc(3S) 

putchar, fputc, putw - put character or word on a ... patc(3S) 

puts, fputs - put a string on a stream pats(3S) 

putw - put character or word on a stream putc(3S) 

pwd - print working directory name pwd(l) 

px - Pascal interpreter. px(l) 

pxp - Pascal execution profiler pxp(l) 

pxref - Pascal cross-reference program pxref(l) 
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ipsqne, remqae - insert /remoye element from a 
Iprm - remove jobs from the line printer spooling 

Ipq - spool 
qsort- 
qsort- 



qaot» - manipalate disk 
setqnota - enable/disable 

r&in - animated 

fortune - print a 

ranlib - convert archives to 

rand, srand - 

random, srandom, initstate, setstate - better 

random number generator; routines for changing/ 



ratfor - 
a stream to a remote command. 



getpass - 

source: 

read, readv - 

readnews - 

wait/ /cd, eval, exec, exit, export, login, newgrp, 

readlink - 

directoiy operations, opendir, 

open - open a file for 



newsrc - information file for 
/cd, eval, exec, exit, export, login, newgrp, read, 

read, 

Iseek, tell - move 

setregid - set 

setreuid - set 

malloc, free, 



re - command script for auto- 
reboot - 
fastboot, fasthalt - 
new aliases - 
recv, recvfrom, recvmsg - 
mail - send and 
/bin/mail - send or 
uurec- 
recnews - 
recnews- 
rmail - handle remote mail 



rehash: 

utmp, wtmp - login 

eyacc - modified yacc allowing much improved error 

socket, 
socket, recv, 
recv, recvfrom, 
eval: 
re_comp, 
documents, 
pxref - Pascal cross- 
index to a bibliography .br lookbib - find 
refer - find and insert literature 
re_comp, re_exec - 

comm - select or 



qsort - quick sort • q8ort(3F) 

qsort - quicker sort q8ort(3) 

queue. ...••....•••••• in8qne(3) 

queue • • Iprm(l) 

queue examination program lp<i(l) 

quick sort qsortfSP) 

quicker sort. . t qsort(3) 

quit - test your knowledge. qniz(6) 

quot - summarize file system ownership qnot(8) 

quota - manipulate disk quotas quota(2) 

quotas quota(2) 

quotas on a file system 8etqnota(2) 

rain - animated raindrops display. rain(6) 

raindrops display rain(6) 

rand, srand - random number generator rand(3C) 

random, hopefully interesting, adage fortune(6) 

random libraries ranlib(l) 

random number generator rand(3C) 

random number generator, routines for changing/ . . . random(3) 

random, srandom, initstate, setstate - better random(3) 

ranlib - convert archives to random libraries ranlib(l) 

ratfor - rational Fortran dialect ratfor(l) 

rational Fortran dialect ratfor(l) 

re - command script for auto-reboot and daemons. . . . rc(8) 

rcmd, rresvport, mserok - routines for returning .... rcmd(3N) 

rep - remote file copy rcp(lC) 

rdate - set S3rstem date from a remote host rdate(8) 

read a password getpas8(3) 

read commands from file. C8h(l) 

read input. . read(2) 

read news articles readnew8(l) 

read, readonly, set, shift, times, trap, umask 8h(l) 

read, readv - read input. rejid(2) 

read value of a symbolic link readiink(2) 

readdir, telldir, seekdir, rewinddir, closedir - directory(3) 

reading or writing, or create a new file open(2) 

readlink - read value of a s]rmbolic link. readlink(2) 

readnews - read news articles readnew8(l) 

readnews(l) and checknews(l) new8rc(5) 

readonly, set, shift, times, trap, umask, wait -/ .... sh(l) 

readv - read input read(2) 

read/write pointer I8eek(2) 

real and effective group ID setregid(2) 

real and effective user ID's 8etreuid(2) 

realloc, calloc, cfree, alloca - memory allocator. malloc(3) 

reboot - reboot system or halt processor reboot(2i 

reboot - UNIX bootstrapping procedures. reboot(8) 

reboot and daemons rc(8) 

reboot system or halt processor. reboot(2) 

reboot /halt the system without checking the disks. • . . fa8tboot(8) 

rebuild the data base for the mail aliases file newaliase8(8) 

receive a message from a socket recv(2) 

receive mail mail(l) 

receive mail among users. binmail(l) 

receive processed news articles via mail. nurec(8) 

receive unprocessed articles via mail recnews(l) 

receive unprocessed articles via mail. recDew8(8) 

received via uucp rmail(8) 

recnews - receive unprocessed articles via mail recnew8(l) 

recnews - receive unprocessed articles via mail recnew8(8) 

re^comp, re.exec - regular expression handler regex(3) 

recompute command hash table C8h(l) 

records ntmp(5) 

recovery. eyacc(l) 

recv, recvfrom, recvmsg - receive a message from a . . . recv(2) 

recvfrom, recvmsg - receive a message from a recv(2) 

recvmsg - receive a message from a socket. recv(2) 

re-evaluate shell data. csh(l) 

re_exec - regular expression handler . regex(3) 

refer - find and insert literature references in refer(l) 

reference program pxref(l) 

references in a bibliography. /- make inverted indxbib(l) 

references in documents refer(l) 

regular expression handler. regex(3) 

rehash: recompute command hash table C8h(l) 

reject lines common to two sorted files. . comm(l) 
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lorder - find ordering 

join - 

- notify the window driver of the physic&l 

sigp&ase - atomically 

strip - remove symbols and 

leave - 

calendar - 

ruserok - routines for returning a stream to a 

rexec - retam stream to a 

rexecd - 

rep - 

rdate - set system date from a 

nnsend - send a file to a 

remote - 

phones - 

riogin - 

riogind - 

rmt- 

rmail - handle 

rsh - 

rshd - 

tip, CQ - connect to a 

rmdel- 

nnlink - 

nndir- 

nnalias: 

flock - apply or 

colrm - 

nnlink - 

insque, remqne - insert/ 

nnsetenv: 

monnt, amoant - mount or 

Iprm- 

deroff - 

expire - 

nnlimit: 

strip - 

rmdir, rm - 

rm, rmdir - 

insqne, 



rename - 
mv - move or 

- file system consistency check and interactive 

trpfpe, fpecnt - trap and 

while: 

nni<i - report 

repeat; execute command 

yes - be 

df- 

iostat - 

uniq - 

vmstat - 

fseek, ftell - 

fseek, ftell, rewind - 

notify: 

state. 

reset - 

arp - address 

arp - Address 

getriimit, setrlimit - control maximum system 

viimit - control maximum system 

limit: alter per-process 

unlimit: remove 

getrusage - get information about 

vtimes - get iiiformation about 

restore - incremental file system 

suspei^d: suspend a shell, 

getarg, iargc - 

idate, itime - 

flmin, flmax, dflmin, dflmax, inmax - 



relation for an object library . lorder(l) 

relational database operator join(l) 

relationships of screens, adjacentscreens ....... adjacentscreea8(l) 

release blocked signals and wait for interrupt. ..... 8igpause(2) 

relocation bits 8trip(l) 

remind you when you have to leave leave(l) 

reminder service calendar(l} 

remote - remote host description file remote(5) 

remote command, rcmd, rresvport rcmd(3N) 

remote command rexec(3N) 

remote execution server. rexecd(8C) 

remote file copy rcp(lC) 

remote host rdate(8) 

remote host au8end(lC) 

remote host description file remote{5) 

remote host phone number data base phone8(5) 

remote login rlogin(lC) 

remote login server rlogind(8C) 

remote magtape protocol module rmt(8C) 

remote mail received via uucp rmail(8) 

remote shell r8h(lC) 

remote shell server r8hd(8C) 

remote system. tip(lC) 

remove a delta from an SCCS file rmdel(l) 

remove a directory entry anlink(3F) 

remove a directory file rmdir(2) 

remove aliases csh(l) 

remove an advisory lock on an open file flock(2) 

remove columns from a file. colTm(l) 

remove directoiy entry anlink(2) 

remove element from a queue insqtte(3) 

remove environment variables c8h(l) 

remove file system mount(2) 

remove jobs from the line printer spooling queue Iprm(l) 

remove nroff, troff, tbl and eqn constructs. . deroff(l) 

remove outdated news articles exptre(8) 

remove resource limitiations csh(l) 

remove symbols and relocation bits strip(l) 

remove funlink) directories or files rmdir(l) 

remove (unlink) files or directories "&(!) 

remque - insert/ remove element from a queue. in8que(3) 

rename - change the name of a file rename(2) 

rename - rename a file rename(3F) 

rename a file rename(3P) 

rename files. mv(l) 

renice - alter priority of running processes renice(8) 

repair, fsck fsck(8} 

repair floating point faults trpfpe(3F) 

repeat commands conditionally csh(l) 

repeat: execute command repeatedly C8h(l) 

repeated lines in a file a&iq(l) 

repeatedly. . C8h(l) 

repetitively affirmative. y«s(l) 

report free disk space on file systems df(l) 

report I/O statistics iostat(8) 

report repeated lines in a file nniq(l) 

report virtual memory statistics. vm8tat(8) 

reposition a file on a logical unit fseek(3F) 

reposition a stream fseek(3S) 

request immediate notification c8h(l) 

reset - reset the teletype bits to a sensible re8et(l) 

reset the teletype bits to a sensible state reset(l) 

resolution display and control arp(8C) 

Resolution Protocol arp('4P) 

resource consumption getriimit(2) 

resource consumption vlimit(3C) 

resource limitations csh(l) 

resource limitiations C8h(l) 

resource utilization getru8age(2) 

resource utilisation vtimes(3C) 

restore re8tore(8) 

restore - incremental file system restore re8tore(8) 

resuming its superior C8h(l) 

return command line arguments getarg(3F) 

return date or time in numerical form idate(3F) 

return extreme values range(3F) 



Sun System Release 1.1 



xxxni 



January 1984 



Permuted Index 



rexec- 

loc- 

rcmd, rresvport, ruserok - roatines for 

rev- 
lastcomm - show last commands executed in 

col - filter 

fseek, ftell, 

opendir, readdir, telldir, seekdir, 



strcmp, stmcmp, strcpy, str&cpy, strlen, index, 

objects, index, 



nndir, 



rm, 



chue - Try to escape to killer 

pow, aqit - exponential, logarithm, power, square 

chroot - change 



fsplit - split a mnlti- 

tgoto, tputs - terminal independent operation 

setstate - better random number generator, 

command, rcmd, rresvport, ntserok - 

- system supporting for local network packet 

packet routing. 

routed - network 

route - manually manipulate the 

itom, madd, msub, mult, mdiv, min, mout, pow, gcd, 

stream to a remote command, rcmd. 



nice, nohup - 

nohup: 

nice: 

roffbib - 

crontab - table of times to 

gcore - get core images of 

renice - alter priority of 

remote command, rcmd, rresvport, 



ec - SCom 10 Mb/ 

en - Sun 3 Mb/ 

pr - print file( 



savecore - 

system. 

brk, 

St - Driver for Sysgen 

scandir, alphasort - 

convenion. 
awk - pattern 
IS - lilog 8530 

cdc - change the delta commentaiy of an 

comb - combine 

delta - make a delta (change) to an 

get - get a version of an 

pn - print an 

rmdel - remove a delta from an 

sccsdiff - compare two versions of an 

sccsfile - format of 



return stream to a remote conxmand rexec(3N) 

return the address of an object loc(3P) 

returning a stream to a remote command rcmd(3N) 

rev - reverse lines of a file w^l) 

reverse lines of a file rcv(l) 

reverse order • lastcomm(l) 

reverse paper motions col(l) 

rewind - reposition a stream f8eek(3S) 

rewinddir, closedir - directory operations directory(3) 

rexec - return stream to a remote command rexec(3N) 

rexecd - remote execution server rexecd(8C) 

rindex - string operations, strcat, stmcat, 8tring(3) 

rindex, inbink, len - tell about character index(3P) 

riogis - remote login rlogin(lC) 

riogind - remote login server rlogind(8C) 

rm - remove (unlink) directories or files rmdir(l) 

rm, rmdir - remove (unlink) files or directories. .... rm(l) 

mail - handle remote mail received via uucp rmail(8) 

rmdel - remove a delta from an SCCS file rmdel(l) 

rmdir - remove (unlink) files or directories nn(l) 

rmdir - remove a directory file rmdir(2) 

rmdir, rm - remove (unlink) directories or files rmdir(l) 

rmt - remote magtape protocol module rmt(8C) 

robots chase(6) 

roffbib - run off bibliographic database roffbib(l) 

root. exp. log, loglO, exp(3M) 

root directory. . . . « chroot(2) 

route - manually manipulate the routing tables route(8C) 

routed - network routing daemon routed(8C) 

routine Fortran file into individual files f8plit(l) 

routines, tgetent, tgetnum, tgetflag, tgetstr teimcap(3X) 

routines for changing generators, /initstate random(3) 

routines for returning a stream to a remote rcmd(3N) 

routing, routing routing(4N) 

routing - system supporting for local netwoik routing(4N) 

routing daemon routed(8C) 

routing tables route(8C) 

rpow - multiple precision integer arithmetic mp(3X) 

rresvport, ruserok - routines for returning a rcmd(3N) 

nh - remote shell r8h(lC) 

rshd - remote shell server r8hd(8C) 

run a command at low priority (sh only) nice(l) 

run command immune to hangups c8h(l) 

run low priority process ("Ml) 

run off bibliographic database roffbib(l) 

run periodic jobs crontab(5) 

running processes. gcore(l) 

running processes renice(8) 

ruptime - show host status of local machines ruptime(lC) 

ruserok - routines for returning a stream to a rcmd(3N) 

rwho - who's logged in on local machines. rwho(lC) 

rwhod - system status server. rwhod(8C) 

s Ethernet interface ec(4S) 

8 experimental Ethernet interface en(4S) 

s), possibly in multiple columns pr(l) 

sa, accton - system accounting sa(8) 

sact - print current SCCS file editing activity. 8act(l) 

sail - mnlti-user wooden ships and iron men sail(6) 

save a core dump of the operating system . savecore(8) 

savecore - save a core dump of the operating savecore(8) 

sbrk - change data segment site brk(2) 

SC 4000 (Archive) Tape Controller. t(4S) 

scan a directory. . . >, scandii(3) 

scandir, alphasort - scan a directory 8candit(3) 

scanf, fscanf, sscanf - formatted input 8canf(3S) 

scanning and processing language. . awk(l) 

sec serial comunications driver. i8(4S) 

sees - front end for the .SM SCCS subsystem 8CC8(l) 

SCCS delta cdc(l) 

SCCS deltas comb(l) 

SCCS file . delta(l) 

sccsfile get(l) 

SCCS file. . . . , pr8(l) 

SCCS file rmdel(l) 

sccsfile 8cc8diff(l) 

sccsfile BCC8fiIe(5) 
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nnzet - undo a previous get of aa 

val - validate 

sact - print current 

admia - create aad administer 

sees - front end for the .SM 



alarm - 

getpriority, setpriority - get/set program 

clear - clear workstation or terminal 

curses - 

ex. vi - 

the window driver of the physical relationships of 

adbgea - generate adb 

re - command 

onintr: process intermpts in command 

Controllen. 

grepi egrep, fgrep - 

xsend, xget, enroll - 

operations, opendir, readdir, telldir, 
brk, sbrk - change data 



case: 

ansend - 

send, sendto, sendmsg - 

kill- 

kill - 

maii- 

sendmail - 

sendnews - 

/bin/mail - 

socket. 

kill - 

killpg - 

aliases - aliases file for 

send, sendto, 

send, 

reset - reset the teletype bits to a 

oct - Central Data octal 

IS - silog 8530 sec 

Comsat - biff 

ftpd - DARI^A Internet Pile Transfer Protocol 

rexecd - remote execution 

riogind - remote login 

rshd - remote shell 

rwhod - system status 

telaetd - DARPA TELNET protocol 

tftpd - DARPA Trivial File Transfer Protocol 

timed - DARPA Time 

servers - inet 

calendar - reminder 

inetd - internet 

logout: etid 

script - make typescript of terminal 

ucii - map of ASCII character 

stty, gtty - 

sigstack - 

sigsetmask - 

gettimeofday, settimeofday - get/ 

nmask - 

utime - 

utimes - 

setgroups - 

gethostname, sethostname - get/ 

getsockopt, setsockopt - get and 

hostname - 

setpgrp - 



sees file . unget(l) 

sees file. . . » val(l) 

sees file editing activity sact(l) 

sees files admin{l) 

sees subsystem 8CC8(1) 

sccsdiff - compare two versions of an SCCS file. .... 8cc8di£f(l) 

sccsfile - format of SCCS file 8ccsfile(5) 

schedule signal after specified time. alarm(3e) 

scheduling priority getpriority(2) 

screen clear(l) 

screen functions with "optimal" cursor motion. .... curses(3X) 

screen oriented (visual) display editor based on vi(l) 

screens, adjacentscreens - notify adjacentscreen8(l) 

script adbgen(8) 

script ~ make typescript of terminal session script(l) 

script for auto-reboot and daemons rc(8) 

scripts C8h(l) 

sd - Disk driver for Adaptec ST-506 Disk sd(4S) 

search a file for a pattern grep(l) 

secret mail. xsend(l) 

sed - stream editor sed(l) 

seekdir, rewinddir, closedir - directory directory(3) 

segment sise brk(2) 

select - synchronous I/O multiplexing select(2) 

select or reject lines common to two sorted files comm(l) 

selector in switch csh(l) 

send a file to a remote host uusend(lC) 

send a message from a socket send(2) 

send a signal to a process kilI(3F) 

send a signal to a process, or terminate a process. . . . kiU(l) 

send and receive mail mail(l) 

send mail over the internet sendmail(8) 

send news articles via mail 8endnews(8) 

send or receive mail among users binmail(l) 

send, sendto, sendmsg - send a message from a .... send(2) 

send signal to a process kill(2) 

send signal to a process group killpg(2) 

sendmail. alia8e8(5) 

sendmail - send mail over the internet sendmail(8) 

sendmsg - send a message from a socket send(2) 

sendnews - send news articles via mail sendnew8(8) 

sendto, sendmsg - send a message from a socket 8end(2) 

sensible state reset(l) 

serial card oct(4S) 

serial comunications driver. S8(4S) 

server. com8at(8e) 

server. ftpd(8e) 

server. rexecd(8e) 

server. rlogind(8C) 

server. r8hd(8C) 

server. rwhod(8C) 

server telnetd(8C) 

server tftpd(8e) 

server. timed(8C) 

server data base servers(5) 

servers - inet server data base servers(5) 

service. calendat(l) 

services - service name data base 8ervice8(5) 

services daemon inetd(8e) 

session C8h(l) 

sessioil. script(l) 

set. :...... ascii(7) 

set and g^ terminal state stty(3e) 

set and/or get signal stack context 8ig8tack(2) 

set: change value of shell variable . C8h(l) 

set current signal mask. sig8etmask(2) 

set date and time gettimeofday(2) 

set file creation mode mask uma8k(2) 

set file times utime(3e) 

set file times utime8(2) 

set group access list 8etgroup8(2) 

set name of current host getho8tname(2) 

set options on sockets getsockopt(2) 

set or print name of current host system ho8tname(l) 

set process group 8etpgrp(2) 

set program priority nice(3C) 
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getpriority, setpriority - get/ 

setregid - 

setreuid - 

/exec, exit, export, login, newgrp, read, readonly, 

rdate - 

getty - 

itty- 

d»te - diapUy or 

aeteuid, setmid, setgid, letegid, setrgid - 

alimit - get and 

getitimer, setitimer - get/ 

seteav: 

to a stream. 

stream, setbnf, 

setnid, setenid, setniid, setgid, 

user and gronp ID. setnid, 

file/ getfsent, getfsspec, getfsfile, getfstype, 

setnid, setenid, setmid, 

getgrent, getgrgid, getgmam, 

gethostent, gethostbyaddr, get host byname, 

gethostname, 

getitimer, 

crypt, 

setbnf, setbnffer, 

getnetent, getnetbyaddr, getnetbyname, 

getpriority, 

getprotoent, getprotobynnmber, getprotobyname, 

getpwent, getpwnid, getpwnam, 



setnid, setenid, setmid, setgid, setegid, 

consumption, getrlimit, 

group ID. setnid, setenid, 

getservent, getservbyport, getservbyname, 

getsockopt, 

routines for changing/ random, srandom, initstate, 

gettimeofday, 

- set user and group ID. 

cd, eval, exec, exit, export, login, newgrp, read,/ 

nice, nohup - mn a command at low priority ( 

- extract strings from C programs to implement 

chsh - change default login 

exit: leave 

rsh - remote 

system - issue a 

csh - a 

eval: re-evalnate 

popd: pop 

pnshd: push 

alias: 

suspend: suspend a 

rshd - remote 

set: change value of 

Q: arithmetic on 

unset: discard 

exec: overiay 

exit, export, login, newgrp, read, readonly, set, 

sail - multi-user wooden 

groups - 

ruptime - 

uptime - 

lastcomm - 

netstat - 

shutdown - 

connection. 



signal 



login - 

pause - stop until 

change the action for a 



set program scheduling priority getpriority(2) 

set real and effective group ID 8etregid(2) 

set real and effective user ID's 8etreuid(2) 

set, shift, times, trap, umaak, watt - command/ .... 8h(l) 

set system date from a remote host rdate(8) 

set terminal mode getty(8) 

set terminal options >tty(l) 

set the date date(l) 

set user and group ID. setnid setuid(3) 

set nier limits nlimit(3C) 

set value of interval timer. getitimei(2) 

set variable in environment C8h(l) 

setbnf, setbnffer, setlinebnf - assign buffering 8etbuf(3S) 

setbnffer, setlinebnf - assign buffering to a 8etbuf(3S) 

setegid, setrgid - set user and group ID 8etuid(3) 

setenv: set variable in environment csh(l) 

setenid, setmid, setgid, setegid, setrgid - set 8etnid(3) 

setfsent, endfsent - get file system descriptor getfsent(3) 

setgid, setegid, setrgid - set user and group ID 8etuid(3) 

setgrent, endgrent - get group file entiy getgrent(3) 

setgronps - set group access list setgroups(2) 

sethostent, endhostent - get network host entiy. , . . . getho3tent(3N) 

sethostname - get/set name of current host getho8tname(2) 

setitimer - get/set value of interval timer getitimeT(2) 

setjmp, longjmp - non-local goto 8etjmp(3) 

setkey, encrypt - DES enciyption crypt(3) 

setlinebnf - assign buffering to a stream 8etbnf(3S) 

setnetent, endnetent - get network entry. getnetent(3N) 

setpgrp - set process group setpgrp(2) 

setpriority - get/set program scheduling priority getpriority(2) 

setprotoent, endprotoent - get protocol entiy getprotoent(3N) 

setpwent, endpwent - get password file entry getpwent(3) 

setqnota - enable/disable quotas on a file system. . . . 8etquota(2) 

setregid - set real and effective group ID 8etregid(2) 

setreuid - set real and effective user ID's setreuid(2) 

setrgid - set user and group ID 8etuid(3) 

setrlimit - control maximum system resource ..... getriimit(2) 

setmid, setgid, setegid, setrgid - set user and ..... setuid(3) 

setservent, endservent - get service entiy getservent(3N) 

setsockopt - get and set options on sockets getsockopt(2) 

setstate - better random number generator; random(3) 

settimeofday - get/set date and time gettimeofday(2) 

setnid, setenid. setmid, setgid, setegid, setrgid setnid(3) 

sh, for, case, if, while, :, ., break, continue sh(l) 

sh only) nice(l) 

shared strings, xstr xstr(l) 

shell chsh(l) 

shell C8h(l) 

shell r8h(lC) 

shell command sy8tem(3) 

shell (command interpreter) with C-like syntax. .... csh(l) 

shell data C8h(l) 

shell directoiy stack. csh(l) 

shell directoiy stack csh(l) 

shell macros C8h(l) 

shell, resuming its superior. C8h(l) 

shell server rshd(8C) 

shell variable csh(l) 

shell variables C8h(l) 

shell variables C8h(l) 

shell with specified command. C8h(l) 

shift: manipulate argument list C8h(l) 

shift, times, trap, umask, wait - command/ /exec, . . . 8h(l) 

ships and iron men. 8ail(6) 

show group memberships group8(l) 

show host status of local machines mptime(lC) 

show how long system has been up nptime(l) 

show last commands executed in reverse order. lastcomm(l) 

show network status net8tat(8) 

shut down part of a full-duplex connection shutdown(2) 

shutdown - close down the system at a given time. . . . shutdown(8) 

shutdown - shut down part of a full-duplex 8hutdown(2) 

sigblock - block signals sigblock(2) 

»'Pion ' login(l) 

8>P»al pau8e(3C) 

»'?»»• ignal(3F) 
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signal - change the action for a signal 8ignal(3P) 

signal - simplified software signal facilities signal(3) 

alarm - schedule signal after specified time alarm(3C) 

signal - simplified software signal facilities signal(3) 

sigvec - software signal facilities. sigvec(2) 

sigsetmask - set current signal mask. sig8etmask(2) 

psignal, 8y8_piglist - system signal messages psignal(3) 

sigstack - set and/or get signal stack context 8ig8tack(2) 

kill - send signal to a process kill(2) 

kill - send a signal to a process kili(3F) 

killpg - send signal to a process group killpg(2) 

kill - send a signal to a process, or terminate a process kill(l) 

sigblock - block signals 8igblock(2) 

sigpause ~ atomieally release blocked signals and wait for interrupt. 8igpau8e(2) 

wait for interrupt, sigpause - atomieally release blocked signals and .... 8igpau8e(2) 

sigsetmask - set current signal mask sig8etma8k(2) 

sigstack - set and/or get signal stack context 8ig3tack(2) 

sigvec - software signal facilities sigvec(2) 

signal - simplified software signal facilities signal(3) 

trigonomrtric functions, sin, cos, tan, asin, acos, atan, atan2 - sin(3M) 

sinb, cosh, tanh - hyperbolic functions sinh(3M) 

null - data sink. . nu!l(4) 

brk, sbrk - change data segment site. brk(2) 

getdtablesise - get descriptor table siie getdtablesize(2) 

getpagesise - get system page site getpagesize(2) 

pagesize - print system page size pagesize(l) 

size - size of an object file size(l) 

size- size of an object file size(l) 

sleep - suspend execution for an interval. 8leep(l) 

sleep - suspend execution for an interval 8leep(3F) 

sleep - suspend execution for interval sleep(3) 

sees - front end for the .SM SCCS subsystem sccs(l) 

ip - Disk driver for Interphase 2180 SMD Disk Controller ip(4S) 

xy - Disk driver for Xylogics SMD Disk Controllers. xy(4S) 

spline - interpolate smooth curve spline(lG) 

snake, snscore - display chase game 8nake(6) 

snake, snscore - display chase game 8nake(6) 

accept - accept a connection on a socket accept(2) 

bind - bind a name to a socket bind(2) 

connect - initiate a connection on a socket connect(2) 

listen - listen for connections on a socket Iisten(2) 

recv, recvfrom, recvmsg - receive a message from a socket recv(2) 

send, sendto, sendmsg - send a message from a socket 8end(2) 

socket - create an endpoint for communication 8ocket(2) 

getsockname - get socket name get8ockname(2) 

socketpair - create a pair of connected sockets socketpair(2) 

getsockopt, setsockopt - get and set options on sockets get8ockopt(2) 

socketpair - create a pair of connected sockets. o . . 8ocketpair(2) 

soelim - eliminate .so't from nroff input 8oelim(l) 

lo - software loopback network interface lo(4) 

signal - simplified software signal facilities. 8ignai(3) 

sigvec - software signal facilities sigvec(2) 

canfield, cfscores - the solitaire card game canfield canfield(6) 

qsort - quicker sdii q8oit(3) 

qsort - quick soH q8ort(3F) 

tsort - topological son t8ort(l) 

|i sort - sort or merge files sort(l) 

sortbib - sort bibliographic database sortbib(l) 

sort- sort or meige files. , 8ort(l) 

sortbib - sort bibliographic database. sortbib(l) 

comm - select or reject lines common to two sorted files comm(l) 

look - find lines in a sorted list. look(l) 

soelim - eliminate 

indent - indent and format C program source « indent(l) 

- create an error message file by massaging C source, mkstr . , mksti(l) 

whereis - locate source, binaiy, and/or manual for program wherei8(l) 

source: read commands from file csh(l) 

mem, kmem, mbmem, mbio - main memory and I/O space mem(4S) 

line, circle, arc, move, cont, point, linemod, space, closepl - graphics interface, /label, plot(3X) 

df - report free disk space on file systems df(l) 

expand, unexpand - expand tabs to spaces, and vice versa expand(l) 

way. vfork - spawn new process in a virtual memory efficient .... vfork(2) 

exec: overlay shell with specified command csh(l) 

head - display first few lines of specified files head(l) 

truncate, ftruncate - truncate a file to a specified length. truncate(2) 

alarm - schedule signal after specified time aiarm(3C) 
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alarm - execute & snbroatine after a 
nrapon - 

gpell, 

spell, spellin, spellout - find 

spell, spellio, 



split - 

files, f split - 

frexp, Idexp, modf - 

naclean - aacp 

Ipq- 

iprm - remove jobs from the line printer 

printf, fprintf, 

exp, log, loglO, pow, 

loglO, pow, sqrt - exponential, logarithm, power, 

rand, 
nnmber generator, routines for changing/ random, 

scanf, fscanf, 

Controller. 

sd - Disk driver for Adaptec 

popd: pop shell directory 

pvshd: posh shell directoiy 

sigstack - set and/or get signal 

imemtest - 

gxtest- 

diag - General-purpose 

stdio- 

htable - convert NIC 

tee - copy 

reset - reset the teletype bits to a sensible 

stty, gtty - set and get terminal 

fsync - synchronise a file's in-core 

if: condition^ 

fstab - 

hashstat: print command hashing 

iostat - report I/O 

perfmon - graphicd display of general system 

vmstat - report virtual memory 

exit - terminate process with 

netstat - show network 

ps - process 

Stat, tstat, fstat - get file 

ferror, feof, clearerr, fileno - stream 

ruptime - show host 

rwhod - system 



wait, waits - wait for process to terminate or 

halt- 

pause - 

icheck - file system 

subroutines, dbminit, fetch, 

strien, index, rindex - string operations. 

rindex - string operations, strcat, stmcat, 

operations, strcat, strncat, strcmp, strncmp, 

fclose, fllush - close or flush a 

fopen, freopea, fdopea - opes a 

fseek, ftell, rewind - reposition a 

fgetc, getw - get character or integer from 

gets, fgets - get a string from a 

putchar, fputc, putw - put character or word on a 

puts, fputs - put a string on a 

setbuffer, setlinebuf - assign buffering to a 

ungetc - push character back into input 

sed - 

ferror, feof, clearerr, fileno - 

rresvport, ruserok - routines for returning a 

rexec - return 

ar - Archive 1/4 inch 

gets, fgets - get a 

puts, fputs - put a 

bcopy, bcmp, bsero, ffs - bit and byte 



specified time aIarm(3F) 

specify additional device for paging and swapping. . . . 8wapon(8) 

spell, spellin, spellout - find spelling errors 8pell(l) 

spellin, spellout - find spelling errors spellfl) 

spelling errors 8pell{l) 

spellout - find spelling errors 8pell(l) 

spline - interpolate smooth curve 8pline(lG) 

split - split a file into pieces 8plit(l) 

split a file into pieces 8plit(l) 

split a multi-routine Fortran file into individual .... fsplit(l) 

split into mantissa and exponent frexp(3) 

spool directoiy clean-up uuclean(8C) 

spool queue examination program Ipq(l) 

spooling queue Iprm(l) 

sprintf - formatted output conversion printf(3S) 

sqrt - exponential, logarithm, power, square root. . . . exp(3M| 

square root, exp, log, exp(3M) 

srand - random number generator rand(3C) 

srandom, initstate, setstate - better random random(3) 

iscanf - formatted input conversion scanf(3S) 

St - Driver for Sysgen SC 4000 (Archive) Tape 8t(4S) 

ST-506 Disk Controllen sd(4S) 

stack csh(l) 

stack csh(l) 

stack context. 8igstack(2) 

stand alone memory test imemtest(8s) 

stand alone test for the Sun video graphics beard. . . . gxte8t(8s) 

stand-alone utility package. . diag(8s) 

standard buffered input/output package tntro(3S) 

standard format host tables htable(8) 

standard output to many files tee(l) 

Stat, Istat, fstat - get file status stat(2) 

state re8et(l) 

state. 8tty(3C) 

state with that on disk f8ync(2) 

statement C8h(l) 

static information about the filesystema fstab(5) 

statistics csb(l) 

statistics iostat(8) 

statistics perfmon(l) 

statistics vmstat(8) 

status exit(3F) 

status net8tat(8) 

status ps(l} 

status stat(2) 

status inquiries ferror(3S) 

status of local machines niptime(lC} 

status server rwhod(8C) 

stdio - standard buffered input /output package intro(3S) 

sticky - executable files with persistent text 8ticky(8) 

stop wait(2) 

stop: halt a job or process C8h(l) 

stop the processor halt(8) 

stop until signal pause(3C) 

storage consistency check icheck(8) 

store, delete, firstkey, nextkey - data base ....... dbm(3X) 

strcat, stmcat, strcmp, strncmp, strcpy, stmcpy 8tring(3) 

strcmp, strncmp, strcpy, stmcpy, strien, index 8tring(3) 

strcpy, stmcpy, strien, index, rindex - string ..... 8tring(3) 

stream fclo8e(3S) 

stream fopen(3S) 

8tream '. fseek(3S) 

stream, getc, getchar getc(3S) 

stream get8(3S) 

stream, putc putc(3S) 

stream put8(3S) 

stream, setbuf, 8etbuf(3S) 

stream ungetc(3S) 

stream editor. 8ed(l) 

stream status inquiries feiToi(3S) 

stream to a remote command, rcmd rcmd(3N) 

stream to a remote command Texec(3N) 

Streaming Tape Drive ^K'*^) 

string from a stream get8(3S) 

string on a stream put8(3S) 

string operations. . b8tring(3) 
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straemp, atrcpy, 8troq>y, strlen, index, rindoc - 
extract striagB from C programs to implement shared 

other binary, file, 
strings, xstr - extrMt 
strings - find printable 

basename - 

strcat, stmcat, strcmp, stmcmp, strcpy, stmcpy, 

index, rindex - string operations, itrcat, 

string operations, strcat, stmcat, strcmp, 

strcat, stmcat, strcmp, stmcmp, strcpy. 



inews- 

postnews - 

alarm - execnte a 

store, delete, firetkey, nextkey - data base 

sn - 
sees - front end for the .SM SCCS 

Bum- 

du- 

qnot- 

en - 

bw- 

eolordemos - demonstrate 

cg- 

cons - driver for 

bsQScnbe - view S-D 

bdemes - demonstrate 

mouse - 

stand alone test for the 

win - 

sun - is cnrrent machine a 

snntools-the 
sync ~ update the 
sync - update the 
periodically update the 
sync - update 
suspend: suspend a shell, resuming its 
Intro - introduction to special files and hardware 

routing - system 

suspend: 

sleep - 

sleep - 

sleep - 



ewab - 

swapon - add a 

paging/swapping. 

swapping. 

swapoB - add a swap device for interleaved paging/ 

iwapoB - specify additional device for paging and 

breaksw: exit from 

case: selector in 

default: catchall clause in 

endsw: terminate 

readlink - read value of a 

symlink - make 

strip - remove 

link. 



disk, fsync - 

select - 

csh - a shell (command interpreter) with C-like 

messages, perror, 
st - Driver for 



string operations, strcat, stmcat, strcmp string(3) 

strings, xstr - X8tr(l) 

strings - find printable strings in an object, or 8trings(l) 

strings from C programs to implement shared X8tr(l) 

strings in an object, or other binary, file string8(l) 

strip - remove symbols and relocation bits 8trip(l) 

strip filename affixes basename(l) 

strlen, index, rindex - string operations 8tring(3) 

stmcat, strcmp, stmcmp, strcpy, strncpy, stilen 8tring(3) 

stmcmp, strcpy, strncpy, strlen, index, rindex - .... 8tring(3) 

stmcpy, strlen, index, rindex - string/ gtring(3) 

stty - set terminal options 8tty(l) 

stty, gtty - set and get terminal state stty(3C) 

su - substitute user id temporarily su(l) 

submit news articles inew8(l) 

submit news articles postnew8(l) 

subroutine after a specified time alarm(3F) 

subroutines, dbminit, fetch dbm(3X) 

substitute user id temporarily 8a(l) 

subsystem 8cc8(l) 

sum - sum and count blocks in a file 8um(l) 

sum and count blocks in a file 8am(l) 

summarize disk usage. ^^(l) 

summarise file system ownership qnot(8) 

sun - is current machine a sun workstation 8an(l) 

Sun 3 Mb/s experimental Ethernet interface en(4S) 

Sun black and white frame buffer. . bw(4S) 

Sun Color Graphics Display colordemos(6) 

Sun color graphics interface cg(4S) 

Sun console. . cons(4S) 

Sun logo. b8uncube(6) 

Sun Monochrome Bitmap Display bdemo8(6) 

Sun mouse mou8ef4S) 

Sun video graphics board gxtesttSs) 

Sun window system win(4S) 

sua workstation 8nn(l) 

suntools - the Suntools window environment 8untools(l) 

Suntools window environment suntool8(l) 

super block. 8ync(l) 

super block sync(8) 

super block update(8) 

super-block 8ync(2) 

superior. csh(l) 

support intro(4) 

supporting for local network packet routing roating(4N) 

suspend a shell, resuming its superior C8h(l) 

suspend execution for an interval 8leep(l) 

suspend execution for an interval sleep(3F) 

suspend execution for interval 8leep(3) 

suspend: suspend a shell, resuming its superior. .... C8h(l) 

swab - swap bytes. 8wab(3) 

swap bytes 8wab(3) 

swap device for interleaved paging/swapping 8wapo&(2) 

swapon - add a swap device for interleaved 8wapon(2) 

swapon - specify additional device for paging and . . . swapon(8) 

swapping. 8wapoa(2) 

swapping 8wapon(8) 

switch cshfl) 

switch C8h(l) 

switch cshfl) 

switch. cshfl) 

switch: multi-way command branch csh(l) 

symbolic link. . readlink(2) 

symbolic link to a file 8ymlink(2) 

symbols and relocation bits 8trip(l) 

symlink - make symbolic link to a file 8ymlink(2) 

symlnk - make a link to an existing file. link(3F) 

sync - update super-block . 8ync(2) 

sync - update the super block 8ync(l) 

sync - update the super block 8ync(8) 

synchronise a file's in-core state with that on ..... fsync(2) 

synchronous I/O multiplexing 8elect(2) 

syntax. ..... c8h(l) 

syscall - indirect system call 8y8caII(2) 

sys.erriist, sys_nerr, ermo - system error perror(3) 

Sysgen SO 4000 (Archive) Tape Controller 8t(4S) 
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peiTor, sys.errlist, 

psignal, 

mti - 

Centronics printer interface, vpc - 

hostid - print identifier of cnrrent host 

hostname - set or print name of current host 

mkfs - constnict a file 

mkproto - construct a prototype file 

mount, nmoant - mount or remove file 

mount, umount - mount and dismount file 

newfs - construct a new file 

savecore - save a core dump of the operatinf 

setquota - enable/disable quotas on a file 

tip, en - connect to a remote 

tunefs - tune up as existing file 

users - compact list of usen who are on the 

vadvise - give advice to pasiBg 

who - who is on the 

win - Sun window 

df - report free disk space on file 

syslog - log 

kgmoB - generate a dump of the operating 

rehash: recompute command hash 

unhash: discard command hash 

keyboard translation table format and default 

mtab - mounted file system 

kbd - keyboard translation 

crontab - 

getdtablesise - get descriptor 

htable - convert NIC standard format host 

route - manually manipulate the routing 

term - terminal driving 

term - terminal driving 

tbi - format 

gettable - g^ NIC format host 

expand, unexpand - expand 

ctags - create a 



talk- 
functions. sin, cos, 
sink, cosh, 
tar- 
tar - 
St - Driver for Sysgea SC 4000 (Archive) 
ar - Archive 1/4 inch Streaming 
tm - tapemaster 1/2 inch 
tp - DEC/mi« 
mtio - UNIX magnetic 
tread, twrite, trewin, tskipf, tstate - f77 
mt - magnetic 
tm- 



deroff - remove nroff, troff, 
f77 tape I/O. topen, 



tektool - 

reset - reset the 

last - indicate last logins of users and 

Iseek, 

index, rindex, Inbink, len - 

operations, opendir, readdir, 

telnet - user interface to the 
telnetd - DARPA 

stt - substitute user id 
tmpnam - create a name for a 



syslog - log systems messages. . . • • syslogfS) 

syslog - make system log entry Byslogll) 

syslog, openlog, closelog - control system log sy8log(3) 

sys_nerr, ermo - system error messages perror(3) 

sysjsiglist - system signal messages psignal(3) 

Systech MTI-800/1600 multi-terminal interface mti(4S) 

Systech VPC-2200 Versatec printer/plotter and .... vpc(4S) 

system hostid(l) 

system hostname(l) 

system mkfs(8) 

system mkproto(8) 

system mount(2) 

system mount(8) 

system newfs(8) 

system Bavecore(8) 

system 8etquota(2) 

system tip(lC) 

system tunef8(8) 

system nser8(l) 

system . vadvise(2) 

system. who(l) 

system winr4S) 

systems df(l) 

systems messages sy8log(8) 

system's profile buffen kgmon(8) 

table c8h(l) 

table csh(l) 

table, kbd . , kbd(5) 

table mtab(5) 

table format and default table kbd(5) 

table of times to run periodic jobs crontab(S) 

table sin geidtable9ise(2) 

tablei htable(8) 

tablet route(8C) 

tablet for nroff. term(5) 

tables for nroff. teim(5) 

tablet for nroff or troff. ^bl(l) 

tablet from a host gettable(8C) 

tabs to spaces, and vice versa expand(l) 

tags file ctags(l) 

tail - display the last part of a file *^1(1) 

talk - talk to another user. talk(l) 

talk to another user ialk(l) 

tan, asin, acos, atan, atan2 - trigonometric 8in(3M) 

tanh - hyperbolic functions 8inh(3M) 

tape archive file format tarfsi 

tape archiver *^^)) 

Tape Controller. . 8t(4S) 

Tape Drive ai<4S) 

tape drive. . tm(4S) 

tape formats tp(5) 

tape interface mtio(4) 

tape I/O. topen, tclose topen(3F) 

tape manipulating program mill) 

tapeouster 1/2 inch tape drive. tm(4S) 

tar - tape archive file format tar(5) 

tar - tape archiver tu(l) 

tbI - format tables for nroff or troff. tbl(l) 

tbI and eqn constructs derof^l) 

tclose, tread, twrite, trewin, tskipf, tstate - ...... topen(3P) 

tcp - Internet Transmission Control Protocol tcp(4P) 

tee - copy standard output to many files. ....... tee(l) 

tektool -Tektronix 4014 terminal emulator tool tektool(l) 

Tektronix 4014 terminal emulator tool tektool(l) 

teletype bits to a sensible state reset(l) 

teletypes |ast(l) 

tell - move read/write pointer l8eek(2) 

tell about character objects index(3P) 

telldir, seekdir, rewinddir, closedir - directory directoiy/S) 

telnet - user interface to the TELNET protocol telnet(lC) 

TELNET protocol telnet(lC) 

TELNET protocol server telnetd(8C) 

telnetd - DARPA TELNET protocol server. telnetd(8C) 

temporarily bu(1) 

temporary file tmpnam(3C) 

term - terminal driving tables for nroff. ,term(5) 
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tty&ame, isatty, ttyslot - find name of a 

vhaagsp - yirtcally "b&sgap" the carrent control 

womu - animate worms on a display 

tenncap - 

tset - establish 

gettytab - 

pty - psendo 

term - 

term - 

tektool - Tektronix 4014 

tgetnnm, tgetflag, tgetstr, tgoto, tpnts - 

ttys - 

mti - Systech MTI-800/1600 mnlti- 

tty - general 

getty - set 

tty - get 

stty - set 

ttynam, isatty - find name of a 

clear - clear workstation or 

script - make typescript of 

stty, gtty - set and get 

ttytype - data base of 

wait - wait for a process to 

_exit - 

kill - send a signal to a process, or 

oatpnt. exit - 

abort - 

endif: 

end: 

wait, waits - wait for process to 

exit - 

endsw: 

imemtest - stand alone memory 

isinf, isnan - 

gxtest - stand alone 

quii- 

sticky - executable files with persistent 

ed- 

ex, edit - 

more, page - browse throngh a 

fmt - simple 

nroff- 

ms - 

server 

- terminal independent operation routines. 

independent operation routines, tgetent, tgetnnm, 

terminal independent operation routines, tgetent, 

operation routines, tgetent, tgetnum, tgetflag, 

routines, tgetent, tgetnum, tgetflag, tgetstr, 

fsysc - synchroniie a file's in>core state with 

ecat - compress and uncompress files, and cat 

w - who is on and what 

more, page - browse 

alarm - schedule signal after specified 

alarm - execute a subroutine after a specified 

at - execute commands at a later 

gettimeofday, settimeof day - get /set date and 

shutdown - close down the system at a given 

time, ftime - get date and 

time- 

getdate - convert 

time: 

idate, itime ~ return date or 
profil - execution 
timed - DARPA 

asctimc, timeione, dysiic - convert date and 

getitimer, setitimer - get/set value of interval 

times - get process 

ntime - set file 



term - terminal driving tables for nroff. term(5) 

tenncap - terminal capability data base tenncap(5) 

terminal . . . . tty&ame(3) 

terminal vhangup(2) 

terminal worms(6) 

terminal capability data base tenncap(5) 

terminal characteristics for the environment tset(l) 

terminal configuration data base gettytab(5) 

terminal driver pty(4) 

terminal driving tables for nroff. tenn(5) 

terminal driving tables for nroff. term(5) 

terminal emulator tool tektool(l) 

terminal independent operation routines, tgetent, ... termcap(3X) 

terminal initialization data ttysfS) 

terminal interface mti(4S) 

terminal interface. tty(4) 

terminal mode getty(8) 

terminal name tty(l) 

terminal options stty(l) 

terminal port ttynam(3F) 

terminal screen clear(l) 

terminal session script(l) 

terminal state stty(3C) 

terminal types by port ttytype(5) 

terminate wait(3P) 

terminate a process. exit(2) 

terminate a process kill(l) 

terminate a process after flushing any pending exit(3) 

terminate abruptly with memory image abort(3F) 

terminate conditional csh(l) 

terminate loop C8h(l) 

terminate or stop. wait(2) 

terminate process with status exit(3F) 

terminate switch csh(l) 

test imemte8t(8s) 

test - condition command ^ . . test(l) 

test for indeterminate floating point values isinf(3) 

test for the Sun video graphics board. gxtest(8s) 

test your knowledge qui>(6) 

text. sticky(8) 

text editor. . edfl) 

text editor. . ex(l) 

text file more(l) 

text formatter. fmt(l) 

text formatting and typesetting nroff(l) 

text formatting macros m8(7) 

tftpd - DARPA Trivial File Transfer Protocol tftpd(8C) 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs termcap(3X) 

tgetflag, tgetstr, tgoto, tputs - terminal termcap(3X) 

tgetnum, tgetflag, tgetstr, tgoto, tputs - termcap(3X) 

tgetstr, tgoto, tputs - terminal independent termcaprsX) 

tgoto, tputs - terminal independent operation termcap(3X) 

that on disk f8ync(2) 

them, compact, uncompact compact(l) 

they are doing w(l) 

through a text file more(l) 

time alarm(3C) 

time alarm(3F) 

time. at(l) 

time ^ gettimeofday(2) 

time shutdown(8) 

time. time(3C) 

time - time a command time(l) 

time a command. time(l) 

time and date from ASCII getdate(3) 

time command c8h(l) 

time, ftime - get date and time time(3C) 

time in numerical form idate(3F) 

time profile. . profil(2) 

Time server. timed(8C) 

time: time command C8h(l) 

time to ASCII, ctime, localtime, gmtime ctime(3) 

timed - DARPA Time server timed(8C) 

timer getitime]:(2) 

times times(3C) 

times atime(3C) 
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Qtimes - set file 

crontab - table of 

/export, login, newgrp, read, readonly, set, shift, 

ASCII, ctime, localtime, gmtime, asctime, 



/iscntrl, isascii, isgraph, toapper, tolower, 

/isprint, iscntrl, isascii, isgrapb, tonpper, 

tektool - Tektronix 4014 terminal emalator 

tstate - f77 tape I/O. 

tsort - 

ispnnct, isprint, iscntri, isascii, isgrapb, 

tgetent, tsetnam, tgetflag, tgetstr, tgote, 

ptrace - process 

trpt - transliterate protocol 

goto: conunand 

ftp - file 

ftpd - DARPA Internet File 

tftpd - DARPA Trivial File 

tr- 

kbd - keyboard 

pi - Pascal interpreter code 

trpt- 

tcp - Internet 

- encode/decode a binaiy file for 

trpfpe, fpecnt - 

login, newgrp, read, readonly, set, shift, times, 

I/O. topen, tclose, 

trek- 

topen, tclose, tread, twrite, 

sin, cos, tan, asin, acos, atan, atan2 - 

tftpd - DARPA 

tbi - format tables for nroff or 

checknr - check nroff/ 

deroff - remove nroff, 

faalts. 

false, 

truncate, ftrancate - 

specified length. 

false, true - provide 

tine, false - provide 

chasi - 

environment. 

topen, tclose, tread, twrite, trewin, 

topen, tclose, tread, twrite, trewin, iskipf, 



terminal. 

ttyname, isatty, 

tnnefs - 

topen, tclose, tread, 

file - determine file 

types - primitive system data 

ttytype - data base of terminal 

script - make 

man - macros to 

eqn, neqn, checkeq - 

troff- 

nroff - text formatting and 

getpw - get name from 



times iitimes(2) 

times - get process times time8(3C) 

times to mn periodic jobs crontab(5) 

times, trap, nmask, wait - command langnage sh(l) 

timeione, dysiie - convert date and time to ctime(3) 

tip, ca - connect to a remote system tipflC) 

tm - tapemaster 1/2 inch tape drive tm(4S) 

tmpnam - create a name for a temporary file. tmpnam(3C) 

toascii - character classification and convenion/ .... ctypefS) 

tolower, toascii - character classification and/ ctype(3) 

tool tektool(l) 

topen, tdose, tread, twrite, trewin, tskipf, topen(3F) 

topological sort tsort(l) 

tonch - apdate date last modified of a file. toach(l) 

tonpper, tolower, toascii - character/ /isspace ctype(3) 

tp - DEC/mag tape formats tp(5) 

tpnts - terminal independent operation routines termcap(3X) 

tr - translate characters ti(l) 

trace ptrace(2) 

trace tipt(8C) 

transfer. csh(l) 

transfer program ftp(lC) 

Transfer Protocol server ftpd(8C) 

Transfer Protocol server tftpd(8C) 

translate characters it{i) 

translation table format and defanlt table kbd(5) 

translator. pi(l) 

transliterate protocol trace tipt(8C) 

Transmission Control Protocol tcp(4P) 

transmission via mail. aaencode,nndecode aaencoide(lC) 

trap and repair floating point faults trpfpe(3F) 

trap, nmask, wait - command language, /export, . . . sh(l) 

tread, twrite, trewin, tskipf, tstate - f77 tape topenf3F) 

trek - trekkie game. trek(6) 

trekkie game trek(6J 

trewin, tskipf, tstate - f77 tape I/O. topen(3F) 

trigonometric functions sin(3M) 

Trivial File Transfer Protocol senrer. tftpd(8C) 

troff. tbl(l) 

troff - typeset or format documents troff(l) 

troff files. checkni(l) 

troff, tbI and eqn constructs deroff(l) 

trpfpe, fpecnt - trap and repair floating point trpfpe(3F) 

trpt - transliterate protocol trace trpt(8C) 

true - provide truth values fal8e(l) 

true, false - provide truth values. true(l) 

truncate a file to a specified length trancate(2) 

truncate, ftruncate - truncate a file to a tiuncate(2) 

truth values. false(l) 

truth values. tiue(l) 

Tiy to escape to killer robots cha8e(6) 

tset - establish terminal characteristics for the tset(l) 

tskipf, tstate - f77 tape I/O topen(3F) 

tsort - topological sort. . tsort(l) 

tstate - f77 tape I/O topen(3F) 

tty - general terminal interface tty(4) 

tty - get terminal name tty(l) 

ttynam, isatty - find name of a terminal port ttynam(3F) 

ttyname, isatty, ttyslot - find name of a ttyname(3) 

ttys - tenninal initialisation data. ttys(5) 

ttyslot - find name of a terminal ttyname(3) 

ttytype - data base of terminal types by port ttytype(5) 

tune up an existing file system. tnnef8(8) 

tunefs - tune up an existing file system tunef8(8) 

twrite, trewin, tskipf, tstate - f77 tape I/O. topen(3F) 

typ«- file(l) 

typ« typesfS) 

types - primitive system data types types(5) 

types by port ttytype(5) 

typescript of terminal session script(l) 

typeset manual man(7) 

typeset mathematics e<in(l) 

typeset or format documents troff(l) 

typesetting nroff(l) 

udp - Internet User Datagram Protocol udp(4P) 

Old 8etpw(3) 
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u\ - do nnderlining oKl) 

nlimit - get and set oser limits alimit(3C) 

omask - set file creation mode mask ama8k(2) 

nmask: change or display file creation mask. ...... csh(l) 

sewgrp, read, readonly, set, shift, times, trap, omask, wait - command langaage. /export, login, . . . 8h(l) 

mount, amount - mount and dismount file system mount(8) 

mount, umount - mount or remove file system mount(2) 

unalias: remove aliases csh(l) 

and cat them, compact, uncompact, ccat - compress and uncompress files, . . . compact(l) 

compact, uncompact, ccat - compress and uncompress files, and cat them compact(l) 

ul - do underlining ul(l) 

unget - undo a previous get of an SCCS file nnget(l) 

expand, unexp&nd - expand tabs to spaces, and vice versa. . . . expand(l) 

unget - undo a previous get of an SCCS file anget(l) 

ungetc - push character back into input stream angetc(3S) 

unhash: discard command hash table csh(l) 

uniq - report repeated lines in a file. uniq(l) 

mktemp - make a unique file name mktemp(3} 

gethostid - get unique identifier of current host gethostid(2) 

flash - flush output to a logical unit fla8h(3F) 

fseek, ftell - reposition a file on a logical unit fseek(3P) 

gete, fgetc - get a character from a logical unit getc(3F) 

fpute - write a character to a FORTRAN logical unit, putc, putc(3F) 

getfd - get the file descriptor of an external unit number. getfd(3F) 

units - conversion program . units(l) 

reboot - UNIX bootstrapping procedures reboot(8) 

system - execute a UNIX command 8ystem(3F) 

uux - Unix to Unix command execution uux(lC) 

uncp, uulog - Unix to unix copy ancp(lC) 

mtio - UNIX magnetic tape interface mtio(4) 

analyse - Virtual UNIX postmortem crash analyzer. analy>e(8) 

uux- unix to unix command execution uux(lC) 

UUCP, uulog- unix to unix copy uucp(lC) 

nnlimit: remove resource limitiations C8h(l) 

unlink - remove a directory entry unlink(3F) 

unlink - remove directory entiy unlink(2) 

rmdir, rm - remove ( unlink) directories or files rmdir(l) 

rm, rmdir - remove ( unlink) files or directories rn^Cl) 

munmap - nnmap pages of memory munmap(2) 

recnews - receive unprocessed articles via mail recnewsfl) 

recnews - receive unprocessed articles via mail recnew8(8) 

unset: discard shell variables csh(l) 

nnsetenv: remove environment variables csh(l) 

uptime - show how long system has been up aptime(l) 

undeaa - uucp spool directory clean- up. .<>..... uaclean(8C) 

tunefa - tune up an existing file system tunefs(8) 

update - periodically update the super block npdate(8) 

touch - update date last modified of a file tonch(l) 

sync - update super-block 8ync(2) 

sync - update the super block 8ync(l) 

sync - update the super block 8ync(8) 

update - periodically update the super block update(8) 

uptime - show how long system has been up uptime(l) 

du - summarise disk usage <lu(l) 

miscellaneous - miscellaneous useful information pages introf?) 

news - USENET network news article, utility files news(5) 

checkncws - check if user has news on the USENET news network checknew8(l) 

login: login new user csh(l) 

talk - tdk to another user. talk(l) 

write - write to another user. write(l) 

aeteuid, setmid, setgid, setegid, setrgid - set user and group 10. setuid setuid(3) 

udp - Internet User Datagram Protocol udp(4P) 

environ - user environment environ(5) 

checknews - check if user has news on the USENET news network checknews(l) 

su - substitute user id temporarily 8a(l) 

getuid, geteuid - get user identity. getuid(2) 

setreuid - set real and effective nserlD's setreuid(2) 

telnet - user interface to the TELNET protocol telnet(lC) 

ulimit - get and set user limits. alimit(3C) 

getuid, getgid - get user or group ID of the caller getuid(3F) 

sail - multi- user wooden ships and iron men sail(6) 

whoami - display effective current usemame whoami(l) 

adduser - procedure for adding new users adduseifs) 

/bin/mail - send or receive mail among users binmail(l) 

wall - write to all nsen wall(l) 

system, users - compact list of users who are on the users(l) 
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last - indtc&te laist logins of 

getlog - get 

users - compact list of 

Tt - view a file without changing it 

news - USENET network news article. 

diag - General-purpose stand-alone 

getmsage - get information aboat resonrce 

vtimes - get information about resource 



rmail - handle remote mail received via 
unclean - 

transmission via mail, unencode, 

unencode - format of an encoded 

for transmission via mail. 

««cp, 



val- 

abs - integer absolute 

fabi, floor, ceil - absolute 

getenv - 

readlink - read 

getenv - get 

getitimer, setitimer - get/set 

set: change 

f^se, true - provide truth 

isnan - test for indeterminate floating point 

fimax, dflmin, dflmax, inmax - return extreme 

true, false - provide truth 

htoni, htons, ntohl, ntohs - convert 

set: change vadue of shell 

varai^ - 

setenv: set 

O: arithmetic on shell 

unset: discard sheti 

unsetenv: remove environment 

getenv - get value of environment 

vax - is current machine a 

asseit - |>rograiii 

lint - 1 1; i>rogtak 

expand, unexpand - expand tabs to spaces, and vice 

vp -Ikon 1«071'5 Multibus 

interface, vpc - Systeeh VP6-2200 

g«t-geta 

what - identify the 

hangman - Computer 

sccsdiff - compare two 

efficient way. 

terminal. 

on ex. 

visual editor. 

vi - view a file without changing it using the 

recnews - receive unprocessed articles 

recnews - receive unprocessed articles 

sendnews - send news articles 

- encode/ decode a binaiy file for transmission 

nurec - receive processed news uticles 

rmail - handle remote mail received 

expand, unexpand - expand tabs to spaces, and 

gxtest - stand alone test for the Sun 

bsuncube - 

editor, vi - 



users and teletypes ^ last(l) 

user's login name getlog(SF) 

usera who are on the system. nsers^l) 

using the vi visual editor view(l) 

utility files news(5) 

utility package. diag(8s) 

utilisation. getm8age(2) 

utilisation. vtime8(3C) 

utime - set file times utime(3C) 

ntimes - set file times. «time8(2) 

utmp, wtmp - login records ntmp(5) 

nucleaa - uucp spool directory clean-up uuclean(8C) 

nucp rmail(8) 

uucp spool directory clean-up. uuclean(8C) 

uucp, uulog - Unix to unix copy uucp(tC) 

nudecode - encode/decode a binary file for ...... uuencodeflC) 

unencode - format of an encoded unencode file uuencode(5) 

uuencode file uuencodefS) 

uuencode,uudecode - encode/decode a binary file .... «uencode(lC) 

uulog - unix to unix copy uucp(lC) 

uurec - receive processed news articles via mail uure^8) 

uusend - send a file to a remote host. . uusend(lC) 

uux - unix to unix command execution. uux(lC) 

vadvise - give advice to paging system vadvi8e(2) 

val - validate sees file val(l) 

validate sees file. . val(l) 

vallee - aligned memory allocator. valloc(3) 

value. abs(3) 

value, floor, ceiling functions. floor(3M) 

value for environment name. getenv(3) 

value ol a qrmbolic link. . readlink(2) 

value of environment variables. getenv(3F) 

value of interval timer getitimer(2) 

value of shell variable. csh(l) 

values false(l) 

values, isinf, isinf(3) 

values, flmin . range(3F) 

values true(l) 

valna between host and network byte oritx. ..... byteonler(3N) 

varugs - variable argument list. . vararg3(3) 

variable C8h(l) 

variable argument list. vararg8(3) 

variable in environment cshfi) 

variables. . C8h(l) 

variables. cshm 

variables. csh(l) 

variables. getenv(3F) 

vax. vaxfll 

vuc - is current machine a vax. . vax(l) 

veri^cation . a88ert(3) 

verifier. , i . . , . Hnt(l) 

versa. expaad(l) 

Venatec parallel printer inte^ace. . . . vp(4S) 

Versatec printer/ plotter and Centronics printer .... vpc(4S) 

veTsioa of an sees file get(l) 

version of files. what(l) 

version of the game hangman. hangman(0) 

versions of an sees file. . scadi9(l) 

vfont - font formats vfont(5) 

vfork - spawn new process in a virtuy memoiy .... vfork(2) 

vgrind - f rind nice listings of programs. . vgrind(l) 

vhangap - virtually "hangup" the current control . . . vhangup{2) 

vi - screen oriented (visual) display editor based .... vi(l) 

vi - view a file without changing it using the vi .... view(l) 

vi visual editor. view(l) 

via mail recnews(l) 

▼iamail recnew8(8) 

▼ia mail 8endnew8(8) 

via mail. unencode,uudecode uuencode(ie) 

via mail uurec(8) 

▼iauucp rmail(8) 

vice versa expand(l) 

video graphics board gxte8t(88) 

view 3-D Sun logo bsuncube(6) 

view a file without changing it using the vi visual . . . view(l) 

vipw - edit the password file vipw(8) 
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vfork - spawn n«w process ia a 

vmst&t - report 

analyze - 

vhangap - 

vi - screen oriented ( 

vi - view a file without changing it nsing the vi 

consnmption. 

fs, inode - format of file system 

printer interface. 

and Centronics printer interface. 

printer interface, vpc - Systech 

utilisation. 



read, readonly, set, shift, times, trap, amask, 

wait " 

wait: 

sigpanse - atomically release blocked signals and 

wait, waits - 

stop. 

wait, 

prmail - print out 

- spawn new process in a virtual memory efficient 



whatis - describe 

crash - 

w - who is on and 

crash - what happens 

leave - remind you 

program. 

and paths (csh only). 

export, login, newgip, read,/ sh, for, case, if, 

break: exit 
bw - Sun black and 

osers - compact list of users 

from- 

w - 

who - 

rwho - 
fold - fold long lines for finite 

lockscreen - maintain 

screens, adjaeentscreens - notify the 

suntools - the Suntools 

win - Sun 

vi - view a file 

fastboot, fasthalt - reboot/halt the system 

sail - multi>user 

wc- 

putc, putchar, fpntc, putw - put character or 

cd - change 

chdir - change current 

getcwd - get pathname of current 

pwd - print 

getwd - get current 

sun - is current machine a sun 

clear - clear 

worm - Play the growing 

worms - animate 

putc, fpntc - 

write, writev - 

Iseek, tell - move read/ 

wall - 



virtual memory eS^cient way vfork(2) 

virtujj memory statistics vmstat(8) 

Virtual UNIX postmortem crash analyzer. . aQalyze{8) 

virtually "hangup" the current control terminal. .... vhaQgup(2) 

visual) display editor based on ex. vi(l) 

visual editor view(l) 

vlimit - control maximum system resource ...... v!imit(3C) 

vmstat - report virtual memory statistics vm8tat(8) 

volume f8(5) 

vp - Ikon 10071-5 Multibus Versatec parallel vp(4S) 

vpc - Systech VPC-2200 Versatec printer/plotter .... vpc(4S) 

VPC-2200 Versatec printer/plotter and Centronics . . . vpc(4S) 

vswap - convert a foreign font file vswap(l) 

vtimes - get information about resource vtime8(3C) 

w - who is on and what they are doing. w(l) 

wait - await completion of process wait(l) 

wait - command language, /export, login, newgrp, . . . 8h(l) 

wait - wait for a process to terminate wait(3P) 

wait for a process to terminate wait(3P) 

wait for background processes to complete C8h(l) 

wait for interrupt sigpau8e(2) 

wait for process to terminate or stop wait(2) 

wait: wait for background processes to complete C8h(l) 

wait, waits - wait for process to terminate or wait(2) 

waits - wait for process to terminate or stop wait(2) 

waiting mail. . prmail(l) 

wall - write to all usen wall(l) 

way. vfork vfork(2) 

wc - word count vc(l) 

what - identify the version of files. what(l) 

what a command is whatis(l) 

what happens when the system crashes crash(8s) 

what they are doing w(l) 

whatis - describe what a command is whatis(l) 

when the system crashes cra8h(8s) 

when you have to leave leave(l) 

whereia - locate source, binary, and/or manual for ... wherei8(l) 

which - locate a program file including aliases which(l) 

while, :, ., break, continue, cd, eval, exec, exit sh(l) 

while: repeat commands conditionally csh(l) 

whiie/foreach loop csh(l) 

white frame buffer bw(4S) 

who - who is on the system who(l) 

who are on the system U8er8(l) 

who is my mail from? from(l) 

who is on and what they are doing w(l) 

who is on the system who(l) 

whoami - display effective current username whoami(l) 

who's logged in on local machines rwho(lC) 

width output device fold(l) 

win - Sun window system win(4S) 

window context until "login" lock8creen(l) 

window driver of the physical relationships of adjacent8creen3(l) 

window environment suQtools(l) 

window system win(4S) 

without changing it using the vi visual editor. view(l) 

without checking the disks fastboot(8) 

wooden ships and iron men 8ail(6) 

word count vc(l) 

word on a stream. , . putc(3S) 

working directory cd(l) 

working directory. . chdir(2) 

working directory getcwd(3F) 

working directory name pt'd(l) 

working directory pathname getwd(3) 

workstation 8un(l) 

workstation or terminal screen clear(l) 

worm - Play the growing worm game worm(6) 

worm game worm(6) 

worms - animate worms on a display terminal worm8(6) 

worms on a display terminal worm8(6) 

write - write to another user. write(l) 

write a character to a FORTRAN logical unit putc(3F) 

write on a file write(2) 

write pointer l8eek(2) 

write to all users. wall(l) 
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write - 

write, 
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Revised for Sun Release 1.1, April 1984 

This document summarizes the facilities provided by the 1.1 and later releases of the UNDCf 
operating system for the Sun Workstation. It does not attempt to act as a tutorial for use of 
the system nor does it attempt to explain or justify the design of the system facilities. It gives 
neither motivation nor implementation details, in favor of brevity. This document is in three 
major parts: 

Part I describes the basic kernel functions provided to a UNIX process: process naming and 
protection, memory management, software interrupts, object references (descriptors), 
time and statistics functions, and resource controls. These facilities, as well as facilities 
for bootstrap, shutdown and process accounting, are provided solely by the kernel. 

Part II describes the standard system abstractions for files and file systems, communication, 
terminal handling, and process control and debugging. These facilities are imple- 
mented by the operating system or by network server processes. 

Part III is an appendix containing a summary of the facilities described in parts I and II. 



Notation and Types 

The notation used to describe system calls is a variant of a C language call, consisting of a pro- 
totype call followed by declaration of parameters and results. An additional kejrword result, 
not part of the normal C language, is used to indicate which of the declared entities receive 
results. As an example, consider the read call, as described in section 8.1: 

cc «■ read(fd, buf, nbytes); 

result int cc; int fd; result char *buf; int nbytes; 

The first line shows how the read routine is called, with three parameters. As shown on the 
second line ce is an integer and read also returns information in the parameter buf. 

Description of all error conditions arising from each system call is not provided here; they 
appear in the System Interface Mariual. In particular, when accessed from the C language, 
many calls return a characteristic -1 value when an error occurs, returning the error code in the 
global variable errno. Other languages may present errors in different ways. 

A number of system standard types are defined in the <iys/ types. h> include file and used in 
the specifications here and in many C programs. These include caddr_t giving a memory 
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address (typically as a character pointer), off_t giving a file o&et (typically as a long integer), 
and a set of unsigned types u_char, ujBhort, u_int and u__long, shorthand names for 
unsigned char, unsigned short, etc. 
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Part I — Kernel Primitives 



Tke facilities available to a UNIX user process are logically divided into t-wo parts: kernel facili- 
ties directly implemented by UNIX code running in the operating system, and system facilities 
Implemented either by the system, or in cooperation with a server process. The kernel facilities 
are described in this part of the document. 

The facilities implemented in the kernel are those which define the UNIX virtual machme which 
each process runs in. Like many real machines, this virtual machine has memory management 
hardware, an interrupt facility, timers and counters. The UNIX virtual machine also allows 
access to files and other objects through a set of descriptors. Each descriptor resembles a device 
controller, and supports a set of operations. Like devices on real machines, some of which are 
Internal to the machine and some of which are external, parts of the descriptor machinery are 
built-in to the operating system, while other parts are often implemented in server processes on 
other machines. The facilities provided through the descriptor machinery are described in Part 
II. 
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1. Processes and Protection 

1.1. Host and Process Identifiers 

Each UNIX host has associated with it a 32-bit host id, and a host name of up to 255 characters. 
These are set (by a privileged user) and returned by the calls: 

sethostid(hostid); 
long hostid; 

hostid = gethostidO; 
result long hostid; 

sethostname(name, len); 
char *name; int len; 

gethostname(buf, buflen); 
result char *buf; int buflen; 

The host id is not used in this release of the system. The 6u/ containing the host name returned 
by gethoatname is null-terminated (if space allows). 

On each host runs a set of processes. Each process is largely independent of other processes, 
having its own protection domain, address space, timers, and an independent set of references to 
system or user implemented objects. 

Each process in a host is named by an integer called the process id. This number is in the range 
1-30000 and is returned by the getpid routine: 

pid =« getpidO; 
result int pid; 

On each UNIX host this identifier is guaranteed to be unique; in a multi-host environment, the 
(hostid, process id) pairs are guaranteed unique. 

1.2. Process Creation and Termination 

A new process is created by making a logical duplicate of an existing process: 

pid = fork(); 
result int pid; 

The fork call returns twice, once in the parent process, where pid is the process identifier of the 
child, and once in the child process where pid is 0. The parent-child relationship induces a 
hierarchical structure on the set of processes in the system. 

A process may terminate by executing an ezit call: 

exit(status); 
int status; 

returning 8 bits of exit status to its parent. 

When a child process exits or terminates abnormally, the parent process receives information 
about any event which caused termination of the child process. A second call provides a non- 
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blocking interface and may also be used to retrieve information about resources consumed by 
the process during its lifetime. 

# include <sys/wait.h> 

pid «> wait(astatus); 

result int pid; result union wait *astatus; 

pid «>■ wait3(astatus, options, arusage); 

result int pid; result union waitstatus *astatus; 

\jit options; result struct rusage * arusage; 

A process can overlay itself with the memory image of another process, passing the newly 
created process a set of parameters, using the call: 

execve(name, argv, envp) 
char '•'name, **argv, **envp; 

The specified name must be a file which is in a format recognized by the system, either a binary 
executable file or a file which causes the execution of a specified interpreter program to process 
its contents. 

1.3. User and Group Ids 

Each process in the system has associated with it two user-id's: a real user id and a effective 
user id, both non-negative 16 bit integers. Each process has an real accounting group id and an 
effective accounting group id and a set of access group id's. The group id's are non-negative 16 
bit integers. Each process may be in several different access groups, with the maximum con- 
current number of access groups a system compilation parameter, the constant NGROUPS in 
the file <8y8/param.h>, guaranteed to be at least 8. 

The real and effective user ids associated with a process are returned by: 

ruid s=s getuidO; 
result int ruid; 

euid =» geteuid(); 
result int euid; 

the real and effective accounting group ids by: 

rgid « getgidO; 
result int rgid; 

egid «» getegidO; 
result int egid; 

and the access group id set is returned by a getgroups call: 

ngroups »= getgroups(gidsetsize, gidset); 

result int ngroups; int gidsetsize; result int gidset[gidsetsize]; 

The user and group id's are assigned at login time using the setreuid, setregid, and setgroups 
calls: 
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setreuid(rmd, euid); 
ii^|; ruid, euid; 

setregid(rgid, egid); 
int rgid, egid; 

setgroups(gidsetsize, gidset); 

int gidsetsize; int gidset [gidsetsize]; 

The seireuid call sets both the real and eJBfective user-id's, while the setregid call sets both the 
real and effective accounting group id's. Unless the caller is the super-user, ruid must be equal 
to either the current real or effective user-id, and rffid equal to either the current real or effective 
accounting group id. The setgroups call is restricted to the super-user. 

1 .4. Process Groups and System Terminals 

Each process in the system is also normally associated with a process group. The group of 
processes in a process group is sometimes referred to as a job and manipulated by high-level sys- 
tem software (such as the shell). The current process group of a process is returned by the 
getpgrp call: 

pgrp = getpgrp(pid); 
result int pgrp; int pid; 

The process group associated with a process may be changed by the setpgrp call: 

setpgrp(pid, pgrp); 
int pid, pgrp; 

Newly created processes are assigned process id's distinct from all processes and process groups, 
and the same process group as their parent. A normal (unprivileged) process may set its process 
group equal to its process id. A privileged process may set the process group of any process to 

any value. 

When a process is in a specific process group it may receive software interrupts affecting the 
group, causing the group to suspend or resume execution or to be interrupted or terminated. la 
particular, every system terminal has a process group and only processes which are in the pro- 
cess group of a terminal may read from the terminal, allowing arbitration of terminals among 
several different jobs. A process can examine the process group of a terminal via the ioctl call: 

ioctl(fd, TIOCGPGRP, pgrp); 
int fd; result int *pgrp; 

A process may change the process group of any terminal which it can write by the ioetl call: 

ioctl(fd, TIOCSPGRP, pgrp); 
int fd; int *pgrp; 

The terminal's process group may be set to any value. Thus, more than one terminal may be in 
a process group. 

Each process in the system is usually associated with a control terminal, accessible through the 
file /dev/tty. A newly created process inherits the control terminal of its parent. A process 
may be in a different process group than its control terminal, in which case the process does not 
receive software interrupts affecting the control terminal's process group. 
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2. Memory management 

This section represents the interface planned for later releases of the system. Of the calls 
described in this section, only sbrk, etpagesize, and mmap are included in the current release. 
Note that mmap is restricted in that it only works with certain character devices such as the 
framebu:^er and devices like mbmem. 

2.1. 'i^ext, Data, and Stack 

Each process begins execution with three logical areas of memory called text, data and stack. 
The text area is read-only and shared, while the data and stack areas are private to the process. 
Both the data and stack areas may be extended and contracted on program request. The call 

addr = sbrk(incr); 

result caddr_t addr; int incr; 

changes the size of the data area by iner bytes and returns the new end of the data area, while 

addr »> sstk(incr); 

result caddr_t addr; int incr; 

changes the size of the stack area. The stack area is also automatically extended as needed. 
On the VAX the text and data areas are adjacent in the PO region, while the stack section is in 
the PI region, and grows downward. 

2.2. gapping Pages 

The systfp supports sharing of data between processes by allowing pages to be mapped into 
memory. These mapped pages may be shared with other processes or private to the process. 
Protection and sharing options are defined in <mman.h> as: 

/* protections are chosen from these bits, or-ed together */ 
#define PROTJREAD 0x4 /* pages can be read */ 

#define PROT_WRITE 0x2 /* pages can be written */ 

#define PROTJEXEC 0x1 /* pages can be executed */ 

/* sharing types; choose either SHARED or PRIVATE ♦/ 
#define MAP.SHARED 1 /* share changes */ 

#define MAP_PRIVATE 2 /* changes are private */ 

The cpu-djppendent size of a page is returned by the getpagesize system call: 

pj^gesize "» getpagesize(); 
reimlt int pagesize; 

The call: 

mmap(addr, len, prot, share, fd, pos); 
caddrjt addr; int len, prot, share, fd; oSjb pos; 

causes the pages starting at addr and continuing for len bytes to be mapped from the object 
represented by descriptor fd, at absolute position pos. The parameter share specifies whether 
modifications made to this mapped copy of the page, are to be kept private, or are to be shared 
with other references. The parameter prot specifies the accessibility of the mapped pages. The 
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addr, Un, and poa parameters must ail be multiples of the pagesize. 

A process can move pages within its own memory by using the mremap call: 

mremap(addr, len, prot, share, fromaddr); 

caddr_t addr; int Icn, prot, share; caddrjt fromaddr; 

This call maps the pages starting at fromaddr to the address specified by addr. 
A mapping can be removed by the call 

nt]iinmap(addr, len); 
cfbddrjt addr; int len; 



This causes further references to these pages to refer to private pages initialized to zero. 

2.3. Page Protection Control 

A process can control the protection of pages using the call 

mprotect(addr, len, prot); 
caddr_t addr; int len, prot; 

This call changes the specified pages to have protection prot. 

2.4. Giving and Getting Advice 

A process that has knowledge of its memory behavior may use the madvise call: 

madvise(addr, len, behav); 
caddr_t addr; int len, behav; 

JSeAav describes expected behavior, as given in <mman.h>: 

#define MADV_NORMAL /* no further special treatment */ 

# define MADVJRANDOM 1 /♦ expect random page references ♦/ 

#define MADV^SEQUENTIAL 2/* expect sequential references */ 

#define MADV_WILLNEED 3 /♦ will need these pages */ 

#define MADV_DONTNEED 4 /♦ don't need these pages ♦/ 

Finally, a process may obtain information about whether pages are core resident by using the 
call 

mincore(addr, len, vec); 

caddrjt addr; int len; result char *vec; 

Here the current core residency of the pages is returned in the character array vcc, with a value 
of 1 meaning that the page is in-core. 
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B» Signals 

The system defines a set of signals that may be delivered to a process. Signal delivery resembles 
the occurrence of a hardware interrupt: the signal is blocked from further occurrence, the 
current process context is saved, and a new one is built. A process may specify the handler to 
which a signal is delivered, or specify that the signal is to be blocked or ignored. A process may 
also spef^ify that a default action is to be taken when signals occur. 

Some siknals will cause a process to exit when they are not caught. This may be accompanied 
by creation of a core image file, containing the current memory image of the process for use in 
post-mortem debugging. A process may choose to have signals delivered on a special stack, so 
that sophisticated software stack manipulations are possible. 

All signals have the same priority. If multiple signals are pending simultaneously, the order in 
which they are delivered to a process is implementation specific. Signal routines execute with 
the signal that caused their invocation blocked, but other signals may yet occur. Mechanisms 
are provided whereby critical sections of code may protect themselves against the occurrence of 
specified signals. 

3.1. Signal Types 

The signals defined by the system fall into one of five classes: hardware conditions, software 
conditions, input/output notification, process control, or resource control. The set of signals is 
defined in the file <signal.h>. 

Hardware signals are derived from exceptional conditions which may occur during execution. 
Such signals include SIGFPE representing floating point and other arithmetic exceptions, 
SIGILL for illegal instruction execution, SIGSEGV for addresses outside the currently assigned 
area of memory, and SIGBUS for accesses that violate memory protection constraints. Other, 
more cpu-specific hardware signals exist, such as those for the various customer-reserved 
instructions on the VAX (SIGIOT, SIGEMT, and SIGTRAP). 

Software signals refi^ect interrupts generated by user request: SIGINT for the normal interrupt 
signal; SIGQUIT for the more powerful quit signal, that normally causes a core image to be gen- 
erated; SIGHUP and SIGTERM that cause graceful process termination, either because a user 
has "hung up", or by user or program request; and SIGKILL, a more powerful termination sig- 
nal which a process cannot catch or ignore. Other software signals (SIGALRM, SIGVTALRM, 
SIGPROF) indicate the expiration of interval timers. 

A process can request notification via a SIGIO signal when input or output is possible on a 
descriptor, or when a non-blocking operation completes. A process may request to receive a 
SIGURG signal when an urgent condition arises. 

A process may be stopped by a signal sent to it or the members of its process group. The SIG- 
STOP signal is a powerful stop signal, because it cannot be caught. Other stop signals 
SIGTSTP, SIGTTIN, and SIGTTOU are used when a user request, input request, or output 
request respectively is the reason the process is being stopped. A SIGCONT signal is sent to a 
process when it is continued from a stopped state. Processes may receive notification with a 
SIGCHLD signal when a child process changes state, either by stopping or by terminating. 

Exceeding resource limits may cause signals to be generated. SIGXCPU occurs when a process 
nears its CPU time limit and SIGXFSZ warns that the limit on file size creation has been 
reached. 
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3.2. Signal Handlers 

A process has a handler associated with each signal that controls the way the signal is delivered. 
The call 

#include <signal.h> 



struct sigvec { 




int 


(*sv_handlerX); 


int 


8V_mask; 


int 


sv_onstack; 


}; 





sigvec(signo, sv, osv) 

int signo; struct sigvec *sv; result struct sigvec ♦osv; 



assigns interrupt handler address tvjkandler to signal »%gno. Each handler address specifies 
either an interrupt routine for the signal, that the signal is to be ignored, or that a default 
action (usually process termination) is to occur if the signal occurs. The constants SIG_IGN 
and SIG_DEF used as values for »v_handler cause ignoring or defaulting of a condition. The 
»v_jna»k and 9v_on9tack values specify the signal mask to be used when the handler is invoked 
and whether the handler should operate on the normal run-time stack or a special signal stack 
(sec below). If 09V is non-zero, the previous signal vector is returned. 

When a signal condition arises for a process, the signal is added to a set of signals pending for 
the process. If the signal is not currently blocked by the process then it will be delivered. The 
process of signal delivery adds the signal to be delivered and those signals specified in the associ- 
ated signal handler's avjmatk to a set of those masked for the process, saves the current process 
context, and places the process in the context of the signal handling routine. The call is 
arranged so that if the signal handling routine exits normally the signal mask will be restored 
and the process will resume execution in the original context. If the process wishes to resume in 
a different context, then it must arrange to restore the signal mask itself. 

The mask of blocked signals is independent of handlers for signals. It prevents signals from 
being delivered much as a raised hardware interrupt priority level prevents hardware interrupts. 
Preventing an interrupt from occurring by changing the handler is analogous to disabling a dev- 
ice from further interrupts. 

The signal handling routine 9V_handler is called by a C csUl of the form 

(♦svJbandlerXsigno, code, scp); 

int signo; long code; struct sigcontext ♦scp; 

The tigno gives the number of the signal that occurred, and the code, a word of information 
supplied by the hardware. The tcp parameter is a pointer to a machine-dependent structure 
containing the information for restoring the context before the signal. 

3.3^ Sending Signals 

A process can send a signal to another process or group of processes with the calls: 



10 Revision E of 7 January 1984 



System Interface Overview Signals 



kill(pid, signo); 
int pid, signo; 

killpgrp(pgrp, signo); 
int pgrp, signo; 

Unless the process sending the signal is privileged, it and the process receiving the signal must 
have the same effective user id. 

Signals are also sent implicitly from a terminal device to the process group associated with the 
terminal when certain input characters are typed. 

3.4. Protecting Critical Sections 

To block a section of code against one or more signals, a sigblock call may be used to add a set 
of signals to the existing mask, returning the old mask: 

oldmask >=» sigblock(mask); 
result long oldmask; long mask; 

The old mask can then be restored later with sigsetmask, 

oldmask => sigsetmask(mask); 
result long oldmask; long mask; 

The sigblock call can be used to read the current mask by specifying an empty mask. 

It is possible to check conditions with some signals blocked, and then to pause waiting for a sig- 
nal and restoring the mask, by using: 

sigpause(mask); 
long mask; 



3.5. Signal Stacks 

Applications that maintain complex or fixed size stacks can use the call 

struct sigstack { 

caddr_t ss_sp; 

int ss_onstack; 

}; 

8igstack(ss, oss) 

struct sigstack '•'ss; result struct sigstack *oss; 

to provide the system with a stack based at ss^sp for delivery of signals. The value ss_on8tack 
indicates whether the process is currently on the signal stack, a notion maintained in software 
by the system. 

When a signal is to be delivered, the system checks whether the process is on a signal stack. If 
not, then the process is switched to the signal stack for delivery, with the return from the signal 
arranged to restore the previous stack. 

If the process wishes to take a non-local exit from the signal routine, or run code from the signal 
stack that uses a different stack, a sigstack call should be used to reset the signal stack. 
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4. Timers 

4.1. Real Time 

The system's notion of the current Greenwich time and the current time lone is set and 
returned by the calls: 

# include <sys/time.h> 

settimeofday(tvp, tzp); 
struct timeval *tp; 
struct timezone *tzp; 

gettimeofdajrftp, tzp); 
result struct timeval *tp; 
result struct timezone *tzp; 

where the structures are defined in <«y«/(tme. A > as: 

struct timeval { 

long tvjsec; /* seconds since Jan 1, 1970 */ 

long tv_jttsec; /* and microseconds */ 

}; 

struct timezone { 

int tz_minuteswest; /* of Greenwich */ 

int tzjdsttime; /* type of dst correction to apply */ 

}; 

Earlier versions of UNIX contained only a 1-second resolution version of this call, which remains 
as a library routine: 

time(tvp) 
result long *tvp; 

or 

tv ■- time(O); 
result long tv; 

returning only the tv.sec field from the gettimeofday call. 

4.2. Interval Time 

The system provides each process with three interval timers, defined in <sys/time.h>: 

#define ITIMERJREAL /* real time intervals ♦/ 

#define ITIMER^VIRTUAL 1 /« virtual time intervals ♦/ 

#define ITIMER_PROF 2 /* user and system virtual time ♦/ 

The ITIMER_REAL timer decrements in real time. It could be used by a library routine to 
maintain a wakeup service queue. A SIGALRM signal is delivered when this timer expires. 
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The ITIMER_yiRTUAL timer decrements in process virtual time. It runs only when the pro- 
cess is executing. A SIGVTALRM signal is delivered when it expires. 

The ITIMER_PROF timer decrements both in process virtual time and when the system is run- 
ning on behalf of the process. It is designed to be used by processes to statistically profile their 
execution. A SIGPROF signal is delivered when it expires. 

A timer value is defined by the itimerval structure: 

struct itimerval { 

struct timeval itjinterval; /* timer interval */ 

struct timeval it__value; /* current value */ 

}; 

and a timer is set or read by the call: 

getitimer(which, value); 

int which; result struct itimerval lvalue; 

setitimer(which, value, ovalue); 

int which; struct itimerval *value; result struct itimerval *ovalue; 

The third argument to setitimer specifies an optional structure to receive the previous contents 
of the interval timer. A timer can be disabled by specifying a timer value of 0. 

The system rounds argument timer intervals to be not less than the resolution of its clock. This 
clock resolution can be determined by loading a very small value into a timer and reading the 
timer back to see what value resulted. 

The alarm system call of earlier versions of UNDC is provided as a library routine using the 
ITIMER_jlEAL timer. The process profiling facilities of earlier versions of UNIX remain 
because it is not always possible to guarantee the automatic restart of system calls after receipt 
of a signal. 

pK>fil(buf, bufsize, ofbet, scale); 

result char '•'buf; int bufsize, offset, scale; 
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5. Descriptors 

Each process has access to resources through descriptor: Each descriptor is a handle allowing 
the process to reference objects such as files, devices and communications links. 

5.1. The Reference Table 

Rather than allowing processes direct access to descriptors, the system introduces a level of 
indirection, so that descriptors may be shared between processes. Each process has a descriptor 
reference table, containing pointers to the actual descriptors. The descriptors themselves thus 
have multiple references, and are reference counted by the system. 

Each process has a fixed size descriptor reference table, where the siae is returned by the getdta- 
blesize call: 

nds ==» getdtablesize(); 
result int nds; 

and guaranteed to be at lesust as large as the constant NOFILE defined in <param.h>. The 
entries in the descriptor reference table are referred to by small integers; for example if there are 
20 slots they are numbered to 19. 

5.2. Descriptor Properties 

Each descriptor has a logical set of properties maintained by the system and defined by its iffpe. 
Each type supports a set of operations; some operations, such as reading and writing, are com- 
mon to several abstractions, while others are unique. The generic operations applying to many 
of these types are described in section 8. Naming contexts, files and directories are described in 
section 9. Section 10 describes communications domains and sockets. Terminals and (struc- 
tured and unstructured) devices are described in section 11. 

5.3. Managing Descriptor References 

A duplicate of a descriptor reference may be made by doing 

n^w ==* dup(old); 
result int new; int old; 

returning a copy of descriptor reference old indistinguishable from the original. The new chosen 
by the system will be the smallest unused descriptor reference slot. A copy of a descriptor refei> 
ence may be made in a specific slot by doing 

dup2(old, new); 
int old, new; 

The dup8 call causes the system to deallocate the descriptor reference current occupying slot 
new, if any, replacing it with a reference to the same descriptor as old. This deallocation is also 
performed by: 

close(old); 
int old; 
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5.4. Multiplexing Requests 

The system provides a standard way to do synchronous and asynchronous multiplexing of 
operations. 

Synchronous multiplexing is performed by using the select call: 

nds =» select(nd, in, out, except, tvp); 

result int nds; int nd; result *in, *out, 't' except; 

struct timeval *tvp; 

The select call examines the descriptors specified by the sets in, out and except, replau;ing the 
specified bit masks by the subsets that select for input, output, and exceptional conditions 
respectively {nd indicates the size, in bits, of the bit masks). If any descriptors meet the follow- 
ing criteria, then the number of such descriptors is returned in nds and the bit masks are 
updated. 

• A descriptor selects for input if an input oriented operation such as read or receive is possi- 
ble, or if a connection request may be accepted (see section 10.1.4). 

• A descriptor selects for output if an output oriented operation such as write or send is possi- 
ble, or if an operation that was "in progress", such as connection establishment, has com- 
pleted (see section 8.3). 

• A descriptor selects for an exceptional condition if a condition that would cause a SIGURG 
signal to be generated exists (see section 3.1). 

If none of the specified conditions is true, the operation blocks for at most the amount of time 
specified by tvp, or waits for one of the conditions to arise if tvp is given as 0. 

Options affecting i/o on a descriptor may be read and set by the call: 

dopt »» fcntl(d, cmd, arg); 
result int dopt; int d, cmd, arg; 

/♦ interesting values for cmd */ 

^define F_SETFL 3 /♦ set descriptor options */ 

#define F_GETFL 4 /* get descriptor options */ 

#define F^SETOWN 5 /* set descriptor owner (pid/pgrp) */ 

#define F_GETOWN 6 /♦ get descriptor owner (pid/pgrp) */ 

The FJSETFL cmd may be used to set a descriptor in non-blocking i/o mode and/or enable sig- 
nalling when i/o is possible. F_SETOWN may be used to specify a process or process group to 
be signalled when using the latter mode of operation. 

Operations on non-blocking descriptors will either complete immediately, note an error 
EWOULDBLOCK, partially complete an input or output operation returning a partial count, or 
return an error EINPROGRESS noting that the requested operation is in progress. A descrip- 
tor which has signalling enabled will cause the specified process and/or process group be sig- 
naled, with a SIGIO for input, output, or in-progress operation complete, or a SIGURG for 
exceptional conditions. 

For example, when writing to a terminal using non-blocking output, the system will accept only 
as much data as there is buffer space for and return; when making a connection on a socket, the 
operation may return indicating that the connection establishment is "in progress". The select 
facility can be used to determine when further output is possible on the terminal, or when the 
connection establishment attempt is complete. 



Revision E of 7 January 1984 15 



Resource Controls 



System Interface Overview 



6. Resource Controls 



6.1. Process Priorities 

The system gives CPU scheduling priority to processes that have not used CPU time recently. 
This tends to favor interactive processes and processes that execute only for short periods. It is 
possible to determine the priority currently assigned to a process, process group, or the processes 
of a specified user, or to alter this priority using the calls: 

#define PRIO_PROCESS /* process */ 

#define PRIO_PGRP 1 /♦ process group */ 

#define PRIO_USER 2 /♦ user id */ 

prio ==» getprioJl*it3r(which, who); 
result int prio; int which, who; 

set priority( which, who, prio); 
int which, who, prio; 

The value prio is in the range -20 to 20. The default priority is 0; lower priorities cause more 
favorable execution. The getpriority call returns the highest priority (lowest numerical value) 
enjoyed by any of the specified processes. The setpriority call sets the priorities of all of the 
specified processes to the specified value. Only the supeF-user may lower priorities. 

6.2. Resource Utiiiiation 

The resources used by a process are returned by a getrmage call, returning information in a 
structure defined in <sys/resource.h>: 

fdefine RUSAGE_SELF /* usage by this process */ 

fdefine RUSAGE^CHILDREN -1/* usage by all children */ 

getrusage(who, rusage); 

int who; result struct rusage *rusage; 



struct rusage { 






struct 


timeval ru_utime; 


/* user time used */ 


struct 


timeval ru_8time; 


/* system time used */ 


int 


ru_maxrss; 


/* maximum core resident set size: kbytes */ 


int 


ru_ixrss; 


/* integral shared memory size (kbytes*sec) */ 


int 


rujdrss; 


/* unshared data " */ 


int 


ru_isrss; 


/* unshared stack " */ 


int 


ru_minflt; 


/* page-reclaims */ 


int 


ru_majflt; 


/* page faults */ 


int 


ru_nswap; 


/* swaps */ 


int 


ru_inblock; 


/* block input operations */ 


int 


ru__oublock; 


/* block output " */ 


int 


ru_msgsnd; 


/♦ messages sent */ 


int 


ru_msgrcv; 


/* messages received */ 


int 


ru__nsignals; 


/* signals received */ 
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int ru_nvcsw; /* voluntary context switches */ 

int ru_mvcsw; /* involuntary ** */ 

}; 

The who parameter specifies whose resource usage is to be returned. The resources used by the 
current process, or by all the terminated children of the current process may be requested. 

0.3. Resource Limits 

The resources of a process for which limits are controlled by the kernel are defined in 
<sy8/resource.h>, and controlled by the getriimit and setrlimit calls: 

#define RLIMIT_CPU /* cpu time in milliseconds */ 

#define RLIMIT_FSIZE 1 /* maximum file size */ 

^define RLIMITJDATA 2 /* maximum data segment size */ 

#define RLIMITJSTACK 3 /* maximum stack segment size */ 

#definc RLIMIT_CORE 4 /* maximum core file size */ 

#define RLIMIT_RSS 5 /* maximum resident set size */ 

#definc RLIM.NLIMITS 6 

#define RLIMJNFINITY 0x7fffffff 

struct rlimit { 

int rlim_cur; /♦ current (soft) limit */ 

int rlim_max; /* hard limit */ 

h 

getrlimit(resource, rip); 

int resource; result struct rlimit ■'■rip; 

setrIimit(resource, rip); 

int resource; struct rlimit *rlp; 

Only the super-user can raise the maximum limits. Other users may only alter rlim_cur within 
the range from to rlimjmax or (irreversibly) lower rlimjmax. 
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7. System operation support 

The calls in this section are permitted only to a privileged user. 

7.1. Bootstrap Operations 

The call 

mount(blkdev, dir, ronly); 
c|iar *blkdev, *dir; int ronly; 

extends the UNIX name space. The mount call specifies a block device 6iX;(/«t; containing a UNIX 
file system to be made available starting at dir. If ronly is set then the file system is read-only; 
writes to the file system will not be permitted and access times will not be updated when files 
are referenced. 

The call 

swapon(blkdev, she); 
char *blkdev; int size; 

specifies a device to be made available for paging and swapping. 

7.2. Shutdown Operations 

The call 

unmount(dir); 
char *dir; 

unmounts the file system mounted on dir. This call will succeed only if the file system is not 
currently being used. 

The call 

sync(); 

schedules input /output to clean all system buffer caches. 
The call 

reboot(how); 
int how; 

causes a machine halt or reboot. The call may request a reboot by specifying how as 
RB_AUTOBOOT, or that the machine be halted with RB_HALT. These constants are defined 
in <sys/reboot.h>. 

7.3. Accounting 

The system optionally keeps an accounting record in a file for each process that exits on the 
system. The format of this record is beyond the scope of this document. The accounting may 
be enabled to a file name by doing 
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acct(path); 
char *path; 

If path is null, then accounting is disabled. Otherwise, the named file becomes the accounting 
file. 
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Part n — System Facilities 



This part of the document discusses the system facilities that are not considered part of the ker- 
nel. 
The system abstractions described are: 

Directoru Contezta 

A dftectory context is a position in the UNIX file system name space. Operations on files 
and lather named objects in a file system are always specified relative to such a context. 

Files 

Files are used to store uninterpreted sequence of bytes on which random access reads and 
writes may occur. Pages from files or devices may also be mapped into process address 
space. A directory may be read as a filef. 

Communications Domains 

A communications domain represents an interprocess communications environment, such as 
the communications facilities of the UNIX system, communications in the INTERNET, or the 
resource sharing protocols and access rights of a resource sharing system on a local network. 

Sockets 

A soclcet is an endpoint of communication and the focal point for IPC in a communications 
domain. Sockets may be created in pairs, or given names and used to rendezvous with 
other sockets in a communications domain, accepting connections from these sockets or 
exchanging messages with them. These operations model a labeled or unlabeled communi- 
cations graph, and can be used in a wide variety of communications domains. Sockets can 
have different types to provide different semantics of communication, increasing the fiexibil- 
ity of the model. 

Terminals and other devices 

Devices include terminals, providing input editing and interrupt generation and output flow 
control and editing, magnetic tapes, disks and other peripherals. They often support the 
generic read and write operations as well as a number of ioctls. 

Processes 

Process descriptors provide facilities for control and debugging of other processes. 



t Support for mapping files b not included in this release. 
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8. Generic Operations 

Many system abstractions support the operations read, write and iocti We describe the basics 
of these common primitives here. Similarly, the mechanisms whereby normally synchronous 
operations may occur in a non-blocking or asynchronous fashion are common to all system- 
defined abstractions and are described here. 

8.1. Read and Write 

The read and write system calls can be applied to communications channels, files, terminals and 
devices. They have the form: 

cc = read(fd, buf, nbytes); 

result int cc; int fd; result caddr_t buf; int nbytes; 

cc == write(fd, buf, nbytes); 

result int cc; int fd; caddrjb buf; int nbytes; 

The read call transfers as muck data as possible from the object defined by fd to the buffer at 
address buf of size nbytes. The number of bytes transferred is returned in cc, which is -1 if a 
return occurred before any data was transferred because of an error or use of non-blocking 
operations. 

The write call transfers data from the buffer to the object defined by fd. Depending on the type 
of fd, it is possible that the write call will accept some portion of the provided bytes; the user 
should resubmit the other bytes in a later request in this case. Error returns because of inter- 
rupted or otherwise incomplete operations are possible. 

Scattering of data on input or gathering of data for output is also possible using an array of 
input/output vector descriptors. The type for the descriptors is defined in <sys/uio.h> as: 

struct iovec { 

caddr_t iov_msg; /* base of a component */ 

int iovjen; /* length of a component */ 

}; 

The calls using an array of descriptors are: 

cc =K readv(fd, iov, iovlen); 

result int cc; int fd; struct iovec 'I'iov; int iovlen; 

cc «=» writcv(fd, iov, iovlen); 

result int cc; int fd; struct iovec *iov; int iovlen; 

Here iovlen is the count of elements in the iov array. 

8.2. Input/Output Control 

Control operations on an object are performed by the ioctl operation: 

ioctl(fd, request, buffer); 

int fd, request; caddr_t buffer; 

This operation causes the specified request to be performed on the object fd. The request 
parameter specifies whether the argument buffer is to be read, written, read and written, or is 
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not needed, and also the size of the buffer, as well as the request. Different descriptor types and 
subtypes within descriptor types may use distinct iocti requests. For example, operations on 
terminals control flushing of input and output queues and setting of terminal parameters; opera- 
tions on disks cause formatting operations to occur; operations on tapes control tape position- 
ing. 

The names for basic control operations are defined in <sys/ioctl.h>. 
8.3. Non-Blocking and Asynchronous Operations 

A process that wishes to do non-blocking operations on one of its descriptors sets the descriptor 
in non-blocking mode as described in section 5.4. Thereafter the read call will return a specific 
EWOULDBLOCK error indication if there is no data to be read. The process may select the 
associated descriptor to determine when a read is possible. 

Output attempted when a descriptor can accept less than is requested will either accept some of 
the provided data, returning a shorter than normal length, or return an error indicating that 
the operation would block. More output can be performed as soon as a select call indicates the 
object is writeable. 

Operations other than data input or output may be performed on a descriptor in a non-blocking 
fashion. These operations will return with a characteristic error indicating that they are in pro- 
gress if they cannot return immediately. The descriptor may then be selected for write to find 
out when the operation can be retried. When select indicates the descriptor is writeable, a 
respecification of the original operation will return the result of the operation. 
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9. File System 

The file system abstraction provides access to a hierarchical file system structure. The file sys- 
tem contains directories (each of which may contain other sub-directories) as well as files and 
references to other objects such as devices and inter-process communications sockets. 

Each file is organized as a linear array of bytes. No record boundaries or system related infor- 
mation is present in a file. Files may be read and written in a random-access fashion. The user 
may read the data in a directory as though it were an ordinary file to determine the names of 
the contained files, but only the system may write into the directories. The file system stores 
only a small amount of ownership, protection and usage information with a file. 

9.1. reaming 

The file ^stem calls take path name arguments. These consist of a zero or more component file 
names separated by *'/" characters, where each file name is up to 255 ASCII characters exclud- 
ing null 4id "/"• 

Each profjess always has two naming contexts: one for the root directory of the file system and 
one for tj^e current working directory. These are used by the system in the filename translation 
process. If a path name begins with a "/"> ** " called a full path name and interpreted relative 
to the root directory context. If the path name does not begin with a '7 ' i^ i^ called a relative 
path name and interpreted relative to the current directory context. 

The system limits the total length of a path name to 1024 characters. 

The file name ".." in each directory refers to the parent directory of that directory. 

The calls 

chdir(path); 
char '•'path; 

chroot(path); 
chp* *path; 

change the current working directory and root directory context of a process. Only the supers 
user can change the root directory context of a process. 

9.2. Creation and Removal 

The file system allows directories, files and special devices, to be created and removed from the 
file system. 

9.2.1. Directory Creation and Removal 

A directory is created with the mkdir system call: 

mkdir(path, mode); 
char *path; int mode; 

and removed with the rmdir system call: 
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#<lefinc 03D0NLY 


000 / 


#define O^WRONLY 


001 / 


#define O^DWR 


002 / 


#define O.NDELAY 


004 / 


#define O.APPEND 


010 / 


#define 0_CREAT 


01000 / 


#define O.TRUNC 


02000 / 


#define O.EXCL 


04000 / 



File System System Interface Overview 



rmdir(path); 
char '•'path; 

A directory must be empty if it is to be deleted. 

9.2.2. File Creation 

Files are createa with the open system call, 

fd = opeii(path, oflag, mode); 

result int fd; char *path; int oflag, mode; 

The patt^ parameter specifies the name of the file to be created. The ofiag parameter must 
include Q GREAT from below to cause the file to be created. The protection for the new file is 
specified |n mode. Bits for oflag are defined in <sys/file.h>: 

/♦ open for reading */ 

/* open for writing */ 

/♦ open for read & write */ 

/* non«blocking open */ 

/* append on each write */ 

/♦ open with file create */ 

/* open with truncation */ 

/* error on create if file exists */ 

One of 0_RDONLY, 0_WRONLY and 0_RDWR should be specified, indicating what types of 
operations are desired to be performed on the open file. The operations will be checked against 
the user's access rights to the file before allowing the open to succeed. Specifying 0_APPEND 
causes writes to automatically append to the file. The flag 0_CREAT causes the file to be 
created if it does not exist, with the specified mode, owned by the current user and the group of 
the containing directory. 

If the open specifies to create the file with OJSXCL and the file already exists, then the open 
will fail without affecting the file in any way. This provides a simple exclusive access facility. 

9.12.3. Creating References to Devices 

The file system allows entries which reference peripheral devices. Peripherals are distinguished 
as block or character devices according by their ability to support block-oriented operations. 
Devices are identified by their "major" and "minor" device numbers. The major device number 
determines the kind of peripheral it is, while the minor device number indicates one of possibly 
many peripherals of that kind. Structured devices have all operations performed internally in 
"block" quantities while unstructured devices often have a number of special ioctl operations, 
and may have input and output performed in large units. The mknod call creates special 
entries: 

mknod(path, mode, dev); 
char *path; int mode, dev; 

where mode is formed from the object type and access permissions. The parameter dev is a 
configuration dependent parameter used to identify specific character or block i/o devices. 
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9.2.4. File and Device Removal 

A reference to a file or special device may be removed with the unlink call, 

unlink(path); 
char *path; 

The caller must have write access to the directory in which the file is located for this call to be 
successful. 

9.3. Reading and Modifying File Attributes 

Detailed information about the attributes of a file may be obtained with the calls: 
#include <sys/stat.h> 

stat(path, stb); 

char *path; result struct stat *stb; 

fstat(fd, stb); 

int fd; result struct stat *stb; 

The »tat structure includes the file type, protection, ownership, access times, size, and a count of 
hard links. If the file is a symbolic link, then the status of the link itself (rather than the file 
the link references) may be found using the latat call: 

lstat(path, stb); 

char *path; result struct stat *stb; 

Newly created files are assigned the user id of the process that created it and the group id of the 
directory fri which it was created. The ownership of a file may be changed by either of the calls 

cl|pwn(path, owner, group); 
ch^ *path; int owner, group; 

fchown(fd, owner, group); 
int fd, owner, group; 

In addition to ownership, each file has three levels of access protection associated with it. These 
levels are owner relative, group relative, and global (all users and groups). Each level of access 
has separate indicators for read permission, write permission, and execute permission. The pro- 
tection bits associated with a file may be set by either of the calls: 

chmod(path, mode); 
char opath; int mode; 

fchmod(fd, mode); 
int fd, mode; 

where mode is a value indicating the new protection of the file. The file mode is a three digit 
octal number. Each digit encodes read access as 4, write access as 2 and execute access as 1, 
or'ed together. The 0700 bits describe owner access, the 070 bits describe the access rights for 
processes in the same group as the file, and the 07 bits describe the access rights for other 
processes. 
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Three additional bits exist: the 04000 *'set-iiser-id" bit can be set on an executable file to cause 
the effective user-id of a process which executes the file to be set to the owner of that file; the 
02000 bit has a similar effect on the effective group-id. The 01000 bit causes an image of an 
executable program to be saved longer than would otherwise be normal; this "sticky" bit is a 
hint to the system that a program is heavily used. 
Finally, the access and modify times on a file may be set by the call: 

utimes(path, tvp); 

char *path; struct timeval '*'tvp[2]; 

This is particularly useful when moving files between media, to preserve relationships between 
the times the file was modified. 

9.4. Links and Renaming 

Links allow multiple names for a file to exist. Links exist independently of the file linked to. 

Two types of links exist, hard links and symbolic links. A hard link is a reference counting 
mechanism that allows a file to have multiple names within the same file system. Symbolic 
links cause string substitution during the pathname interpretation process. 

Hard links and symbolic links have different properties. A hard link insures the target file will 
always be accessible, even after its original directory entry is removed; no such guarantee exists 
for a symbolic link. Symbolic links can span file systems boundaries. 

The following calls create a new link, named pathSf to pathl: 

link(pathl, path2); 
char *pathl, *path2; 

symlink(pathl, path2); 
char *pathl, *path2; 

The unlink primitive may be used to remove either type of link. 

If a file is a symbolic link, the "value" of the link may be read with the readlink czllf 

\ej^ *>" readlink(path, buf, bufsize); 

result int len; result char *path, *buf; int bufsize; 

This call returns, in 6ti/, the null-terminated string substituted into pathnames passing through 
path . 

Atomic renaming of file system resident objects is possible with the rename call: 

rename(oidname, new name); 
char ^oldname, '(■newname; 

where both oldname and newname must be in the same file system. If newname exists and is a 
directory, then it must be empty. 

9.5. Extension and Truncation 

Files are created with zero length and may be extended simply by writing or appending to 
them. While a file is open the system maintains a pointer into the file indicating the current 
location in the file associated with the descriptor. This pointer may be moved about in the file 
in a random access fashion. To set the current offset into a file, the heek call may be used. 
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oldoffset = lseek(fd, offset, t.ype); 

result offjt oldo£Eset; int fd; off_t offset; int type; 

where type is given in <sys/file.h> as one of, 

#define L_SET /* set absolute file offiset */ 

^define LJNCR 1 /* set file offiset relative to current position */ 

#define L JCTND 2 /* set offset relative to end-of-file */ 

The call "lseek(fd, 0, L_INCR)" returns the current offset into the file. 

Files may have "holes" in them. Holes are void areas in the linear extent of the file where data 
has never been written. These may be created by seeking to a location in a file past the current 
end-of-file and writing. Holes are treated by the system as zero valued bytes. 

A file may be truncated with either of the calls: 

truncate(path, length); 
char *path; int length; 

ftruncate(fd, length); 
int fd, length; 

reducing the sise of the specified file to iength bytes. 

9.6. Checking Accessibility 

A process running with different real and effective user ids may interrogate the accessibility of a 
file to the real user by using the access call: 

accessible = access(path, how); 

result int accessible; char *path; int how; 

Here how is constructed by or'ing the following bits, defined in <sys/file.h>: 

#define F_OK /* file exists */ 

#define X_OK 1 /* file is executable */ 

#define WjOK 2 /* file is writable */ 

#define R_OK 4 /* file is readable */ 

The presence or absence of advisory locks does not affect the result of access . 

9.7. Locking 

The file system provides basic facilities that allow cooperating processes to synchronize their 
access to shared files. A process may place an advisory read or write lock on a file, so that other 
cooperating processes may avoid interfering with the process' access. This simple mechanism 
provides locking with file granularity. More granular locking can be built using the IPC facili- 
ties to provide a lock manager. The system does not force processes to obey the locks; they are 
of an advisory nature only. 

Locking is performed after an operi call by applying the flock primitive, 

flock(fd, how); 
int fd, how; 

where the Aou; parameter is formed from bits defined in <sys/file.h>: 
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#definc LOCK_SH 1 /♦ shared lock */ 

#define LOCK_EX 2 /♦ exclusive lock ♦/ 

#define LOCK_NB 4 /* don't block when locking */ 

#define LOCK.UN 8 /♦ unlock */ 

Successive lock calls may be used to increase or decrease the level of locking. If an object is 
currently locked by another process when a flock call is made, the caller will be blocked until the 
current lock owner releases the lock; this may be avoided by including LOCK_NB in the how 
parameter. Specifying LOCK_UN removes all locks associated with the descriptor. Advisory 
locks held by a process are automatically deleted when the process terminates. 

0.8. Disk Quotas 

As an optional facility, each file system may be requested to impose limits on a user's disk 
usage. Two quantities are limited: the total amount of disk space which a user may allocate in 
a file system and the total number of files a user may create in a file system. Quotas are 
expressed as hard limits and toft limits. A hard limit is always imposed; if a user would exceed 
a hard limit, the operation which caused the resource request will fail. A soft limit results in the 
user receiving a warning message, but with allocation succeeding. Facilities are provided to turn 
soft limits into hard limits if a user has exceeded a soft limit for an unreasonable period of time. 

To enable disk quotas on a file system the setquota call is used: 

setquota(special, file); 
char ^special, *file; 

where special refers to a structured device file where a mounted file system exists, and file refers 
to a disk quota file (residing on the file system associated with special) from which user quotas 
should be obtained. The format of the disk quota file is implementation dependent. 

To manipulate disk quotas the quota call is provided: 
#include <sys/quota.h> 

quota(cmd, uid, arg, addr); 
int cmd, uid, arg; caddr_t addr; 

The indicated cmd is applied to the user ID uid. The parameters arg and addr are command 
specific. The file <sys/quota.h> contains definitions pertinent to the use of this call. 
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10. Interprocess Communications 

10.1. Interprocess Communication Primitives 



10.1.1. Communication Domains 

The system provides access to an extensible set of communication domains. A communication 
domain is identified by a manifest constant defined in the file <sys/socket.h>. Important 
standard domains supported by the system are the UNIX domain, AF_UNIX, for communication 
within the system, and the "internet" domain for communication in the DARPA internet, 
AFJNET. Other domains can be added to the system. 

10.1.2. Socket Types and Protocols 

Within a domain, communication takes place between communication endpoints known as sock- 
ets. Each socket has the potential to exchange information with other sockets within the 
domain. 

Each socket has an associated abstract type, which describes the semantics of communication 
using that socket. Properties such as reliability, ordering, and prevention of duplication of mes- 
sages are determined by the type. The basic set of socket types is defined in <sys/socket.h>: 

/♦ Standard socket types */ 

#define SOCK_DGRAM 1 /* datagram ♦/ 

#define SOCK_STREAM 2 /* virtual circuit */ 

#define SOCK^RAW 3 /* raw socket */ 

#define SOCK^RDM 4 /* reliably-delivered message */ 

#define SOCK_SEQPACKET 5 /* sequenced packets */ 

The SOCKJDGRAM type models the semantics of datagrams in network communication: mes- 
sages may be lost or duplicated and may arrive out-of-order. The SOCK_RDM type models the 
semantics of reliable datagrams: messages arrive unduplicated and in-order, the sender is 
notified if messages are lost. The send and receive operations (described below) generate 
reliable/unreliable datagrams. The SOCK_STREAM type models connection-based virtual cir- 
cuits: two-way byte streams with no record bound^ies. The SOCK_SEQPACKET type models 
a connection-based, full-duplex, reliable, sequenced packet exchange; the sender is notified if 
messages are lost, and messages are never duplicated or presented out-of-order. Users of the 
last two abstractions may use the facilities for out-of-band transmission to send out-of-band 
data. 

SOCK_RAW is used for unprocessed access to internal network layers and interfaces; it has no 
specific semantics. 
Other socket types can be defined.f 

Each socket may have a concrete protocol associated with it. This protocol is used within the 
domain to provide the semantics required by the socket type. For example, within the 



t This release does not support the SOCKJIDM and SOCK_SEQPACKET types. 
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"internet" domain, the SOCK_DGRAM type may be implemented by the UDP user datagram 
protocol, and the SOCKJSTREAM type may be implemented by the TCP transmission control 
protocol, while no standard protocols to provide SOCK_RDM or SOCK_SEQPACKET sockets 
exist. 

10.1.3. Socket Creation, Naming^ and Service Establishment 

Sockets may be connected or unconnected. An unconnected socket descriptor is obtained by the 
socket call: 

s =■ socket(domain, type, protocol); 
result int s; int domain, type, protocol; 

An unconnected socket descriptor may yield a connected socket descriptor in one of two ways: 
either by actively connecting to another socket, or by becoming associated with a name in the 
communications domain and accepting a connection from another socket. 

To accept connections, a socket must first have a binding to a name within the communications 
domain. Such a binding is established by a 6inif call: 

bind(s, name, namelen); 

int s; chsur *name; int namelen; 

A socket's bound name may be retrieved with a gettockname call: 

getsockname(s, name, namelen); 

int s; result caddrjt name; result int '^namelen; 

while the peer's name can be retrieved with getpeername: 

getpeername(s, name, namelen); 

int s; result caddr.t name; result int ^namelen; 

Domains may support sockets with several names. 

10.1.4. Accepting Connections 

Once a binding is made, it is possible to listen for connections: 

listen(s, backlog); 
int s, backlog; 

The backlog specifies the maximum count of connections that can be simultaneously queued 
awaiting acceptance. 

An accept call: 

t » accept(s, name, anamelen); 

result int t; int s; result caddrjt name; result int ^anamelen; 

returns a descriptor for a new, connected, socket from the queue of pending connections on s. 
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10.1.5. Making Connections 

An active connection to a named socket is made by the connect call: 

connect(s, name, namelen); 

int s; caddrjb name; int namelen; 

It is also possible to create connected pairs of sockets without using the domain's name space to 
rendezvous; this is done with the socketpair calif: 

socketpair(d, type, protocol, sv); 
int d, type, protocol; result int sv[2]; 

Here the returned sv descriptors correspond to those obtained with accept and connect. 
The call 

pipe(pv); 
result int pv[2]; 

creates a pair of SOCK_STREAM sockets in the UNIX domain, with pv[0] only writeable and 
pv[l] only readable. 

10.1.6. Sending and Receiving Data 

Messages may be sent from a socket by: 

cc = sendto(s, buf, len, flags, to, tolen); 

result int cc; int s; caddr_t buf; int len, flags; caddr_t to; int tolen; 

if the socket is not connected or: 

cc = send(s, buf, len, flags); 

result int cc; int s; caddr_t buf; int len, flags; 

if the socket is connected. The corresponding receive primitives are: 

msglen «=■ recvfrom(s, buf, len, flags, from, fromlenaddr); 
result int msglen; int s; result caddrjt buf; int len, flags; 
result caddr_t from; result int ■'■fromlenaddr; 



and 



msglen >» recv(8, buf, len, flags); 

result int msglen; int s; result caddr_t buf; int len, flags; 



In the unconnected case, the parameters to and tolen specify the destination or source of the 
message, while the from parameter stores the source of the message, and *fromlenaddr initially 
gives the size of the from buffer and is updated to reflect the true length of the from address. 

All calls cause the message to be received in or sent from the message buffer of length len bytes, 
starting at address buf. The flags specify peeking at a message without reading it or sending or 
receiving high-priority out-of-band messages, as follows: 



t This release supports $oeketpair creation only in the "unix" communication domain. 
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struct msghdr { 




caddrjt 


msg_name; 


int 


msg namelen; 


struct 


iov *msg_iov; 


int 


nisg_iovlen; 


caddr_t 


msg_accrights; 


int 


msg_ac crightslen; 



Interprocess Communications System Interface Overview 



#define MSG_PEEK 0x1 /* peek at incoming message */ 

#define MSGjOOB 0x2 /* process out-of-band data ♦/ 



10.1.7. Scatter/Gather and Exchanging Access Rights 

It is possible to scatter and gather data and to exchange access rights with messages. When 
either of these operations is involved, the number of parameters to the call becomes large. Thus 
the system defines a message header structure, in <8ys/socket.h>, which is used to contain the 
parameters to the calls: 

/* optional address */ 

/♦ size of address */ 

/* scatter/gather array */ 

/♦ # elements in msg_iov ♦/ 

/* access rights sent /received */ 

/* size of msgjaccrights */ 

}; 

Here m»g_name and msgjnamelcn specify the source or destination address if the socket is 
unconnected; msgjnamt may be given as a null pointer if no names are desired or required. The 
msg_iov and msg_iovlen describe the scatter /gather locations, as described in section 8.3. Access 
rights to be sent along with the message are specified in msg__accrightSf which has length 
m»g_accright»len. In the "unix" domain these are an array of integer descriptors, taken from 
the sending process and duplicated in the receiver. 

This structure is used in the operations sendmag and recvmsg: 

sendmsg(s, msg, flags); 

int s; struct msghdr '•'msg; int flags; 

msglen =: recvmsg(s, msg, flags); 

result int msglen; int s; result struct msghdr '•■msg; int flags; 



10.1.8. Using Read and Write with Sockets 

The normal UNIX read and write calls may be applied to connected sockets and translated into 
send and receive calls from or to a single area of memory and discarding any rights received. A 
process may operate on a virtual circuit socket, a terminal or a file with blocking or non- 
blocking input/output operations without distinguishing the descriptor type. 

10.1.9. Shutting Down Halves of Full-Duplex Connections 

A process that has a full-duplex socket such as a virtual circuit and no longer wishes to read 
from or write to this socket can give the call: 

shutdown(s, direction); 
int s, direction; 

where direction is to not read further, 1 to not write further, or 2 to completely shut the 
32 Revision E of 7 January 1984 



Systeni Interface Overview 



Interprocess Communicatioiis 



eomieetioii down. 

10.1.10. Socket and Protocol Options 

Sockets, and their underlying communication protocols, may support options. These options 
may be used to manipulate implementation specific or non-standard facilities. The getaockopt 
and seisockopi calls are used to control options: 

getso€kopt(s, level, optname, optval, optlen); 

int s, level, optname; result caddr_J; optval; result int *optlen; 

setsockopt(s, level, optname, optval, optlen); 
Int s, level, optname; caddr_t optval; int optlen; 

The option optname is interpreted at the indicated protocol level for socket s. If a value is 
specified with optval and optlen, it is interpreted by the software operating at the specified level. 
The level SOL_SOCKET is reserved to indicate options maintained by the socket facilities. 
Other level values indicate a particular protocol which is to act on the option request; these 
values are normally interpreted as a "protocol number". 

10.2. UNIX Domain 

This section describes briefly the properties of the UNIX communications domain. 

10.2.1. Types of Sockets 

la the UNIX domain, the SOCKJSTREAM abstraction provides pipe-like facilities, while 
SOCK_DGRAM provides datagrams - unreliable message-style communications. 

10.2.2. Naming 

Socket names are strings and may appear in the UNIX file system name space through portalsf. 

10.2.3. Access Rights Transmission 

The ability to pass UNIX descriptors with messages in this domain allows migration of service 
within the system and allows user processes to be used in building system facilities. 

10.3. INTERNET Domain 

This section describes briefly how the INTERNET domain is mapped to the model described in 
this section. More information will be found in the Networking Implementation Notes in the 
System Internals Manual. 



t The current implementation of the UNIX domain embeds bound sockets in the UNIX file system 
name space; this b a side eBect of the implementation. 
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10.3.1. Socket Types and Protocols 

SOCK.STREAM is supported by the INTERNET TCP protocol; SOCK_DGRAM by the UDP 
protocol. The SOCK_SEQPACKET has no direct INTERNET family analogue; a protocol 
based on one from the XEROX NS family and layered on top of IP could be implemented to fill 
this gap. 

10.3.2. Socket Naming 

Sockets in the INTERNET domain have names composed of the 32 bit internet address, and a 
16 bit port number. Options may be used to provide source routing for the address, security 
options, or additional addresses for subnets of INTERNET for which the basic 32 bit addresses 
are insufficient. 

10.3.3. Access Rights Transmission 

No access rights transmission facilities are provided in the INTERNET domain. 

10.3.4. Raw Access 

The INTERNET domain allows the super-user access to the raw facilities of the various net- 
work intei'faces and the various internal layers of the protocol implementation. This allows 
administrative and debugging functions to occur. These interfaces are modeled as SOCK_RAW 
sockets. 
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11. Devices 

The system uses a collection of device-drivers to access attached peripherals. Such devices are 
grouped into two classes: structured devices on which block- oriented input/output operations 
occur, and unstructured devices (the rest). 

11.1. Structured Devices 

Structured devices include disk and tape drives, and are accessed through a system buffer- 
caching mechanism, which permits them to be accessed as ordinary files are, performing reads 
and writes as necessary to allow random-access. 

The mount command in the system allows a structured device containing a file system volume 
to be accessed through the UNIX file system calls. 

Tape drives also typically provide a structured interface, although this is rarely used. 

11.2. Unstructured Devices 

Unstructured devices are those devices which do not support a randomly accessed block struc- 
ture. 

Communications lines, raster plotters, normal magnetic tape access (in large or variable size 
blocks), and access to disk drives permitting large block transfers and special operations like 
disk formatting and labelling all use unstructured device interfaces. 

The writing of devices for unstructured devices other than communications lines is described in 
the Device Driver Manual in the System Internals Manual. 
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12. Debugging Support 

The ptrace facility of version 7 UNIX is provided in this release. Planned enhancements which 
would allow a descriptor^ based process control facility have not been implemented. 
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Appendbc A. Sununary of Facilities 



A,l« Kernel Primitives 



A«l«l. Process Naming and Protection 



sethostid 


set UNIX host id 


gethostid 


get UNIX host id 


sethostname 


set UNIX host name 


gethostnafne 


get UNIX host name 


getpid 


get process id 


fork 


create new process 


exit 


terminate a process 


cxecve 


execute a different process 


getuid 


get user id 


geteuid 


get effective user id 


setreuid 


set real and effective user id's 


getgid 


get accounting group id 


getegid 


get effective accounting group id 


getgroups 


get access group set 


setregid 


set real and effective group id's 


setgroups 


set access group set 


getpgrp 


get process group 


setpgrp 


set process group 



A. 1.2. Memory Managemient 



<mman.h> 

sbrk 

sstkf 



memory management definitions 
change data section size 
change stack section size 



t Not supported in the 1.1 Sun release. 
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getpagesize 

mm apt 

mremapt 

munmapf 

mprotectf 

madvisef 

mincoref 



get memory page size 

map pages of memory 

remap pages in memory 

unmap memory 

change protection of pages 

give memory management advice 

determine core residency of pages 



A. 1.3. Signals 



<signal.h> 

sigvcc 

kill 

killpgrp 

sigblock 

sigsetmask 

sigpause 

sigstack 



signal definitions 

set handler for signal 

send signal to process 

send signal to process group 

block set of signals 

restore set of blocked signals 

wait for signals 

set software stack for signals 



A. 1.4. Timing and Statistics 



<sys/time.h> 

gettimeofday 

settimeofday 

getitimer 

setitimer 

profil 



time-related definitions 

get current time and timezone 

set current time and timezone 

read an interval timer 

get and set an interval timer 

profile process 



A. 1.5. Descriptors 



getdtablesize 

dup 

dup2 

close 

select 

fcntl 



descriptor reference table size 
duplicate descriptor 
duplicate to specified index 
close descriptor 
multiplex input/output 
control descriptor options 



t Not supported in the 1.1 Sun release. 
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A. 1.6. Resource Controls 



<5ys/rc50urce.h > 

getpriority 

setpriority 

getrusage 

getrlimit 

setrlimit 



resource-related definitions 
get process priority 
set process priority 
get resource usage 
get resource limitations 
set resource limitations 



A.1.7. System Operation Support 



mount 

swapon 

umount 

sync 

reboot 

acct 



mount a device file system 
add a swap device 
umount a file system 
flush system caches 
reboot a machine 
specify accounting file 



A.2. System Facilities 



A.2.1. Generic Operations 



read 


read data 


write 


write data 


<8y8/uio.h> 


scatter-gather related definitions 


readv 


scattered data input 


writcv 


gathered data output 


<sy8/ioctI.h> 


standard control operations 


ioctl 


device control operation 



A.2.2. File System 

Operations marked with a * exist in two forms: as shown, operating on a file name, and operat- 
ing on a file descriptor, when the name is preceded with a "r\ 



<sys/file.h> 


file system definitions 


chdir 


change directory 


chroot 


change root directory 


mkdir 


make a directory 


rmdir 


remove a directory 


open 


open a new or existing file 


mknod 


make a special file 


unlink 


remove a link 


Stat* 


return status for a file 
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Istat 

chown* 

chmod* 

utimes 

link 

symlink 

readlink 

rename 

Iseek 

truncate"* 

access 

flock 



returned status of link 

change owner 

change mode 

change access/modify times 

make a hard link 

make a symbolic link 

read contents of symbolic link 

change name of file 

reposition within file 

truncate file 

determine accessibility 

lock a file 



A.2.3. Interprocess Communications 



<sys/socket.h> 


standard definitions 


socket 


create socket 


bind 


bind socket to name 


getsockname 


get socket name 


listen 


allow queueing of connections 


accept 


accept a connection 


connect 


connect to peer socket 


socketpair 


create pair of connected sockets 


sendto 


send data to named socket 


send 


send data to connected socket 


recvfrom 


receive data on unconnected socket 


recv 


receive data on connected socket 


sendmsg 


send gathered data and/or rights 


recvmsg 


receive scattered data and/or rights 


shutdown 


partially close full-duplex connection 


getsockopt 


get socket option 


setsockopt 


set socket option 



A.2.4. Devices 



A.2.5. Debugging Support 
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NAME 

intro - introduction to system calls and error numbers 

SYNOPSIS 

#lnclude <errno.h> 

DESCRIPTION 

I'his section describes allof the system calls. Most of these calls have one or more error returns. 
m error condition is indicated by an otherwise impossible return value. This is almost always -1; 
llie individual descriptions specify the details. 

As with normal arguments, all return codes and values from functions are of type integer unless 
Otherwise noted. An error number is also made available in the external variable errno, which is 
not cleared on successful calls. Thus errno should be tested only after an error has occurred. 

I^lte following is a complete list of the errors and their names as given in <errno.h>. 

m Error 

Unused. 

1 EPERM Not owner 
Typically this error indicates an attempt to modify a file in some way forbidden except to 
its owner or super-user. It is also returned for attempts by ordinary users to do things 
allowed only to the super-user. 

2 ENOENT No such file or directory 
This error occurs when a file name is specified and the file should exist but doesn't, or 
when one of the directories in a path name does not exist. 

3 ESRCH No such process 
:". The process whose number was given to kilt and ptrace does not exist, or is already dead. 

4 EINTR Interrupted system call 
An asynchronous signal (such as interrupt or quit), which the user has elected to catch, 
occurred during a system call. If execution is resumed after processing the signal, it will 
appear as if the interrupted system call returned this error condition. 

5 EIO I/O error 
Some physical I/O error occurred during a read or write. This error may in some cases 
occur on a caH following the one to which it actually applies. 

6 ENXIO No such device or address 
I/O on a special file refers to a subdevice which does not exist, or beyond the limits of the 
device. It may also occur when, for example, an illegal tape drive unit number is selected 
or a disk pack is not loaded on a drive. 

7 E2BIG Arg list too long 
An argument list longer than 10240 bytes is presented to execve. 

8 ENOEXEC Exec format error 
A request b made to execute a file which, although it has the appropriate permissions, 
does not start with a valid magic number, see a.out{5), 

9 EBADF Bad file number 
Either a file descriptor refers to no open file, or a read (resp. write) request is made to a 
file which is open only for writing (resp. reading). 

10 ECHILD No children 
Wait and the process has no living or unwaited-for children. 

11 EAGAIN No more processes 
In a fork, the system's process table is full or the user is not allowed to create any more 
processes. 
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12 ENOMEM Not enough core 

During an execve or break, a program asks for more core or swap space than the system is 
able to supply. A lack of swap space is normally a temporary condition, however a lack 
of core is not a temporary condition; the maximum size of the text, data, and stack seg- 
ments is a system parameter. 

13 EACCES Permission denied 

An attempt was made to access a file in a way forbidden by the protection system. 

14 EFAULT Bad address 

The system encountered a hardware fault in attempting to access the arguments of a sys> 
tern call. 

15 ENOTBLK Block device required 

A plain file was mentioned where a block device was required, e.g. in mount. 

16 EBUSY Mount device busy 

An attempt to mount a device that was already mounted or an attempt was made to 
dismount a device on which there is an active file directory, (open file, current directory, 
mounted-on file, active text segment). 

17 EEXIST File exists 

An existing file was mentioned in an inappropriate context, e.g. link. 

18 EXDEV Cross-device link 

A hard link to a file on another device was attempted. 

19 ENODEV No such device 

An attempt was made to appty an inappropriate system call to a device; e.g. read a 
write-only device. 

20 ENOTDIR Not a directory 

A non-directory was specified where a directory is required, for example in a path name 
or as an argument to chdir. 

21 EISDIR Is a directory 

An attempt to write on a directory. 

22 EINVAL Invalid argument 

Some invalid argument: dismounting a non-mounted device, mentioning an unknown sig- 
nal in signal, reading or writing a file for which etek has generated a negative pointer. 
Also set by math functions, see %ntro(Z). 

23 ENFILE File table overfioW 

The system's table of open files is full, and temporarily no more optns can be accepted. 

24 EMFILE Too many open file! 

Customary configuration limit is 20 per process. 

25 ENOTTY Not a typewriter 

The file mentioned in an ioctl is not a terminal or one of the other devices to which these 
calls apply. 

26 ETXTBSY Text file busy 

An attempt to execute a pure-procedure program which is currently open for writing (or 
reading!). Also an attempt to open for writing a pure-procedure program that is being 
executed. 

27 EFBIQ File too large 

The size of a file exceeded the maximum (about 10* bytes). 

28 ENOSPC No space left on device 

During a write to an ordinary file, there is no free space left on the device. 
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29 ESPIPE IllegaJseek 

An laeek was issued to a pipe. This error may also be issued for other non-seekable dev- 
ices. 

30 EROFS Read-oBly file system 

An attempt to modify a file or directory was made on a device mounted read-only. 

31 EMLINK Too many links 

An attempt to make more than 32767 hard links to a file. 

32 EPIPE Broken pipe 

A write on a pipe or socket for which there is no process to read the data. This condition 
normally generates a signal; the error is returned if the signal is ignored. 

33 EDOM Math argument 

The argument of a function in the math library (as described in section 3M) is out of the 
domain of the function. 

34 ERANGE Result too large 

The value of a function in the math library (as described in section 3M) is unrepresent- 
able within machine precision. 

35 EWOULDBLOCK Operation would block 

An operation which would cause a process to block was attempted on a object in non- 
blocking mode (see ioctl{2)). 

36 EINPROGRESS Operation now in progress 

An operation which takes a long time to complete (such as a connect{2)) was attempted 
on a non-blocking object (see iocU{2)). 

37 EALREADY Operation already in progress 

An operation was attempted on a non-blocking object which already had an operation in 
progress. 

38 ENOTSOCk Socket operation on non-socket 

Self-explanatory. 

39 EDESTADDRRfeQ Destination address required 

A requiired address was omitted from an operation on a socket. 

40 EMSGSIZE Message too long 

A message sent on a socket was larger than the internal message buffer. 

41 EPROTOTYPEJ Protocol wrong type for socket 

A protocol was specified which does not support the semantics of the socket type 
requested. For example you cannot use the ARPA Internet UDP protocol with type 
SOCK_STREAM. 

42 ENOPROTOOPT Bad protocol option 

A bad option was specified in a get80ckopt{2) or 8et80ckopt{2) call. 

43 EPROTONOSUPPORT Protocol not supported 

The protocol has not been configured into the system or no implementation for it exists. 

44 ESOCKTNOSUPPORT Socket type not supported 

The support for the socket type has not been configured into the system or no implemen- 
tation for it exists. 

45 EOPNOTSUPP Operation not supported on socket 

For example, trying to accept a connection on a datagram socket. 

46 EPFNOSUPPORT Protocol family not supported 

The protocol family has not been configured into the system or no implementation for it 
exists. 
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47 EAFNOSUPPORT Address family not supported by protocol family 

An address incompatible with the requested protocol was used. For example, you 
shouldn't necessarily expect to be able to use PUP Internet addresses with ARPA Inter- 
net protocols. 

48 EADDRINUSE Address already in use 

Only one usage of each address is normally permitted. 

49 EADDRNOTAVAIL Can't assign requested address 

Normally results from an attempt to create a socket with an address not on this machine. 

50 ENETDOWN Network is down 

A socket operation encountered a dead network. 

51 ENETUNREACH Network is unreachable 

A socket operation was attempted to an unreachable network. 

52 ENETRESET Network dropped connection on reset 

The host you were connected to crashed and rebooted. 

53 ECONNABORTED Software caused connection abort 

A connection abort was caused internal to your host machine. 

54 ECONNRESET Connection reset by peer 

A connection was forcibly closed by a peer. This normally results from the peer execut- 
ing a 8hutdown{2) call. 

55 ENOBUFS No buffer space available 

An operation on a socket or pipe was not performed because the system lacked sufficient 
buffer space. 

56 EISCONN Socket is already connected 

A connect request was made on an already connected socket; or, a sendto or sendmsg 
request on a connected socket specified a destination otheir than the connected party. 

57 ENOTCONN Socket is not connected 

An request to send or receive data was disallowed because the socket is not connected. 

58 ESHUTDOWN Can't send after socket shutdown 

A request to send data was disallowed because the socket had already been shut down 
witk a previous 8hutdown{2) call. 

59 unused 

60 ETIMEDdUT Connection timed out 

A connect request failed because the connected party did not properly respond after a 
period of time. (The timeout period is dependent on the communication protocol.) 

61 ECONNREFUSED Connection refused 

No connection could be made because the target machine actively refused it. This usu- 
ally results from trying to connect to a service which is inactive on the foreign host. 

62 ELOOP Too many levels of embolic links 

A path name lookup involved more than 8 embolic links. 

63 ENAMETOOLONG File name too long 

A component of a path name exceeded 255 characters, or an entire path name exceeded 
1023 characters. 

64 ENOTEMPTY Directory not empty 

A directory with entries other than •*." and '*.." was supplied to a remove directory or 
rename call. 
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DEFINITIONS 

Descriptor 

An integer assigned by the system when a file is referenced by op en (2), dup{2), or pipe(2) or 
a socket is referenced by 8ccket{2) or 80cketpair{2) which uniquely identifies an access path 
to that file or socket from a given process or any of its children. 

Directory 

A directory is a special type of file which contains entries which are references to other files. 
Directory entries are called links. By convention, a directory contains at least two links, . 
and .., referred to as dot and dot-dot respectively. Dot refers to the directory itself and dot- 
dot refers to its parent directory. 

Effective User Id, Effective Group Id, and Access Groups 

Access to system resources is governed by three values: the effective user ID, the effective 
group ID, and the group access list. 

The effective user ID and effective group ID are initially the process's real user ID and real 
group ID respectively. Either may be modified through execution of a set-user-ID or set- 
group-ID file (possibly by one its ancestors); see €xecve{2). 

The group access list is an additional set of group ED's used only in determining resource 
accessibility. Access checks are performed as described below in "File Access Permissions". 

File Access Permissions 

Every file in the file system has a set of access permissions. These permissions are used in 
determining whether a process may perform a requested operation on the file (such as open- 
ing a file for writing). Access permissions are established at the time a file is created. They 
may be changed at some later time through the chmod{2) call. 

File access is broken down according to whether a file may be: read, written, or executed. 
Directory files use the execute permission to control if the directory may be searched. 

File access permissions are interpreted by the system as they apply to three different classes 
of users: the owner of the file, those users in the file's group, anyone else. Every file has an 
independent set of access permissions for each of these classes. When an access check is 
made, the system decides if permission should be granted by checking the access informar 
tion applicable to the caller. 

Read, write, and execute/search permissions on a file are granted to a process if: 

The process's effective user ID is that of the super-user. 

The process's effective user ID matches the user ID of the owner of the file and the owner 
permissions allow the access. 

The process's effective tisisr ID does not match the user ID of the owner of the file, and 
either the process's effective group ID matches the group ID of the file, or the group ID of 
the file is in the process's group access list, and the group permissions allow the access. 

Neither the effective user ID nor effective group ID and group access list of the process 
match the corresponding user ID and group ID of the file, but the permissions for "other 
users" allow access. 

Otherwise, permission is denied. 

File Name 

Names consisting of up to 255 characters may be used to name an ordinary file, special file, 
or directory. 

These characters may be selected from the set of all ASCII character excluding (null) and 
the ASCII code for / (slash). (The parity bit, bit 8, must be 0.) 

Note that it is generally unwise to use *, ?, { or j as part of file names because of the special 
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meaning attached to these characters by the shell. 

Parent Process ID 

A new process is created by a currently active process; see fork{2). The parent process ID of 
a process is the process ID of its creator. 

Path Name 

A path name is a null-terminated character string starting with an optional slash (/), fol- 
lowed by zero or more directory names separated by slashes, optionally followed by a file 
name. The totad length of a path name must be less than {PATHNAME.MAX} characters. 

If a path name begins with a slash, the path search begins at the root directory. Otherwise, 
the search begins from the current working directory. A slash by itself names the root 
directory. A null pathname refers to the current directory. 

Process Group ID 

Each active process is a member of a process group that is identified by a positive integer 
called the process group ID. This is the process ID of the group leader. This grouping per- 
mits the signalling of related processes (see lnUpg{2)) and the job control mechanisms of 

C8h{l). 

Process ID 

Each active process in the system b uniquely identified by a positive integer called a process 
ID. The range of this ID is from to 3CX)00. 

Real User ID and Real Group ID 

Each user on the system is identified by a positive integer termed the real user ID. 

Each user is also a member of one or more groups. One of these groups is distinguished from 
others and used in implementing accounting facilities. The positive integer corresponding to 
this distinguished group is termed the real group ID. 

All processes have a real user ID and real group ID. These are initialized from the 
equivalent attributes of the process which created it. 

Root Directory and Current Working Directory 

Each process has associated with it a concept of a root directory and a current working 
directory for the purpose of resolving path name searches. A process's root directory need 
not be the root directory of the root file system. 

Sockets and Address Families 

A socket is an endpoint for communication between processes. Each socket has queues for 
sending and receiving data. 

Sockets are typed according to their communications properties. These properties include 
whether messages sent and received at a socket require the name of the partner, whether 
communication is reliable, the format used in naming message recipients, etc. 

Each instance of the system supports some collection of socket types; consult 80cket{2) for 
more information about the types available and their properties. 

Each ihstance of the system supports some number of sets of communications protocols. 
Each protocol set supports addresses of a certain format. An Address Family is the set of 
addresses for a specific group of protocok. Each socket has an address chosen from the 
address family in which the socket was created. 

Special Processes 

The processes with a process ID's of 0, 1, and 2 are special. Process is the scheduler. Pro- 
cess 1 is the initialization process init, and is the ancestor of every other process in the sys- 
tem. It is used to control the process structure. Process 2 is the paging daemon. 

Super-user 

A process is recognized as a super-tiser process and is granted special privileges if its 
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effective user ID is 0. 

Tty Group ID 

Each active process can be a member of a terminal group that is identified by a positive 
integer called the tty group ID. This grouping is used to arbitrate between multiple jobs 
contending for the same terminal; see C8h{l), and tty{4). 

ALSO 

intro(3); perror(3) 
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NAME 

accept - accept a connection on a socket 

SYNOPSIS 

#inelude <iyB/types.h> 
#iiiclude <syt/socket.h> 

na a=: aceept(By addr, addrlen) 
int nu, 8{ 

struct sockaddr *addr{ 
int '''ftddrlen; 

DESCRIPTION 

The argument 9 is a socket which has been created with 8ocket{2), bound to an address with 
bind{2), and is listening for connections after a U8ten{2). Accept extracts the first connection on 
the queue of pending connections, creates a new socket with the same properties of s and allocates 
a new file descriptor, ns, for the socket. If no pending connections are present on the queue, and 
the socket is not marked as non-blocking, accept blocks the caller until a connection is present. If 
the socket is marked non-blocking and no pending connections are present on the queue, accept 
returns an error as described below. The accepted socket, na, is used to read and write data to 
and from the socket which connected to this one; it is not used to accept more connections. The 
original socket 8 remains open for accepting further connections. 

The argument addr is a result parameter which is filled in with the address of the connecting 
eptity, as known to the communications layer. The exact format of the addr parameter b deter- 
nf|ned by the domain in which the communication is occurring. The addrlen is a value-result 
parameter; it should initially contain the amount of space pointed to by addr; on return it will 
contain the actual length (in bytes) of the address returned. This call is used with connection- 
based socket types, currently with SOCK_STREAM. 

It is possible to aelect{2) a socket for the purposes of doing an acet^t by selecting it for read. 

RETURN VALUE 

The call returns -1 osi error. If it succeeds it returns a non-negative integer which is a descriptor 
for the acc&i^sed socket. 

ERRORS 

The accept will fail if: 

(EBADFj The descriptor is invalid. 

(ENOTSOCK) The descriptor references a file, not a socket. 

(EOPNOTSUPPl The referenced socket is not of type SOCK_STREAM. 

[EFAULT] The addr parameter is not in a writable part of the user address space. 

(EWOULDBLOCK) The socket is marked non-blocking and no connections are present to be 
accepted. 

SEE ALSO 

bind(2), connect(2), listen(2), select(2), 80cket(2) 
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NAME 

access - determine accessibility of file 

SYNOPSIS 

^include <8yB/file.h> 

#define R_OK 4 /* test for read permission */ 

#define W_OK 2 /* test for write permission */ 

#define X_OK 1 /* test for execute (search) permission */ 

#define F_OK /* test for presence of file */ 

accessible =s access(path, mode) 
int accessible; 
char *path; 
int mode; 

DESCRIPTION 

Access checks the given file path for accessibility according to mode, which is an inclusive or of 
the bits R_OK, W_OK and X_OK. Specifying mode as F_OK (i.e. 0) tests whether the direc- 
tories leading to the file can be searched and the file exists. 

The real user ID and the group access list (including the red group ID) are used in verifying per- 
mission, so thu call is useful to set>UID programs. 

Notice that only access bits are checked. A directory may be indicated as writable by access, but 
an attempt to open it for writing will fail (although files may be created there); a file may look 
executable, but execve will fail unless it is in proper format. 

RETURN VALUE 

If path cannot be found or if any of the desired access modes would not be granted, then a -1 
value is returned; otherwise a value is returned. 

ERRORS 

Access to the file is denied if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

(ENOENT) The argument path name was too long. 

[ENOENT] Read, write, or execute (search) permission is requested for a null path name or 

the named file does not exist. 

[EPERM] The argument contains a byte with the high-order bit set. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EROFS] Write access is requested for a file on a read-only file system. 

jETXTBSY] Write access is requested for a pure procedure (shared text) file that is being exe- 
cuted. 

[EACCES] Permission bits of the file mode do not permit the requested access; or search 

permission is denied on a component of the path prefix. The owner of a file has 
permission checked with respect to the "owner" read, write, and execute mode 
bits, members of the file's group other than the owner have permission checked 
with respect to the "group" mode bits, and all others have permissions checked 
with respect to the "other" mode bits. 

[EFAULT] Path points outside the process's allocated address space. 

SEE ALSO 

chmod(2), stat(2) 
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NAME 

acct - turn accounting on or off 

SYNOPSIS 

acct(flle) 
char *flle; 

DESCRIPTION 

The system is prepared to write a record in an accounting JUe for each process as it terminates. 
This call, with a null-terminated string naming an existing file as argument, turns on accounting; 
records for each terminating process are appended to JUe. An argument of causes accounting to 
be turned off. 

The accounting file format u given in acc{(5). 

'^^ This call is permitted only to the super-user. 

NOTES 

Accounting is automatically disabled when the file qrstem the accounting file resides on runs out 
of space; it is enabled when space once again becomes available. 

RETURN VALUE 

On error -1 is returned. The file must exist and the call may be exercised only by the super-user. 
It is erroneous to try to turn on accounting when it is already on. 

ERRORS 

Acct will fail if one of the following is true: 

[EPERM] The caller is not the super-user. 

(EPERM] The pathname contains a character with the high-order bit set. 

[ENOTDIR] A component of the path prefix is not a directory. 

(ENOENT) The named file does not exist. 

[EISDIR] The named file is a directory. 

[EROFS) The named file resides on a read-only file system. 

[EFAULT] File points outside the process's allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EACCES] The file b a character or block special file. 

SEE ALSO , 

acct(5), sa(8) 

BUGS 

No accounting is produced for programs running when a crash occurs. In particular nonterminat- 
ing programs are never accounted for. 
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NAME 

bind - bind a name to a socket 

SYNOPSIS 

^include <Bys/type8.h> 
^include <8ys/Bocket.h> 

t^|nd(8, name, namelen) 

t|ruct soekaddr *Dame; 
l||t namelen) 

DESORIffTION 

Bind assigns a name to an unnamed socket. When a socket is created with 8ocket{2) it exists in a 
name space (address family) but has no name assigned. Bind requests the name, be assigned to 
the socket. 

NOTES 

Binding a name in the UNIX domain creates a socket in the file system which must be deleted by 
the caller when it is no longer needed (using unlink{2)). 

The rules used in name binding vary between communication domains. Consult the manual 
entries in section 4 for detailed information. 

RETURN VALUE 

If the bind is successful, a value is returned. A return value of -1 indicates an error, which is 
further specified in the global errno. 

ERRORS 

The bind call will fail if: 

(EBADFj 5 is not a valid descriptor. 

(ENOTSOCK] S is not a socket. 

(EADDRNOTAVAIL] The specified address is not available from the local machine. 

[EADDRINUSE] The specified address is already in use. 

[EINVAL] The socket is already bound to an address. 

[EACCES] The requested address is protected, and the current user has inadequate 

permission to access it. 

{EFAULT] The name parameter is not in a valid part of the user address space. 

SEE ALSO 

connect(2), listen(2), socket(2), getsockname(2) 

BUGS 

The file created is a side-effect of the current implementation and will not be created in future 
versions of the UI^DC ipc domain. 



Sun Release 1.1 Last change: 4 January 1984 11 



BRK ( 2 ) SYSTEM CALLS BRK ( 2 ) 



NAME 

brk, sbrk - change data segment size 

SYNOPSIS 

caddr_t brk(addr) 
caddr_t addr; 

caddr_t 8brk(iiicr) 
Int incr} 

DESCRIPTION 

Brk sets the system's idea of the lowest data segment location not used by the program (called the 
break) to addr (rounded up to the next multiple of the system's page size). Locations greater 
than addr and below the stack pointer are not in the address space and will thus cause a memory 
violation if accessed. 

In the alternate function sbrk, iher more bytes are added to the program's data space and a 
pointer to the start of the new area is returned. 

When a program begins execution via execve the break is set at the highest location defined by 
the program and data storage areas. Ordinarily, therefore, only programs with growing data 
areas need to use sbrk. 

The getrlimit{2) system call may be used to determine the maximum permissible size of the data 
segment; it will not be possible to set the break beyond the rtim_max value returned from a call 
to getrlimit, e.g. "etext + rlp-*rlim_max." (See end{Z) for the definition of etext.) 

RETURN VALUE 

Zero is returned if the brk could be set; -1 if the program requests more memory than the system 
limit. Sbrk returns -1 if the break could not be set. 

ERRORS 

Sbrk will fail and no additional memory will be allocated if one of the following are true: 

[ENOMEM] The limit, as set by 8etrlimit{2), was exceeded. 

[ENOMEM] The maximum possible size of a data segment (compiled into the system) was 
exceeded. 

[ENOMEM] Insufficient space existed in the swap area to support the expansion. 

SEE ALSO 

execve(2), getrlimit(2), malloc(3), end(3) 

BUGS 

Setting the break may fail due to a temporary lack of swap space. It is not possible to distinguish 
this from a failure caused by exceeding the maximum size of the data segment without consulting 

getrlimit. 
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NAME 

chdir - change current working directory 

SYNOPSIS 

chdir(path) 
char ""path} 

DESCRIPTION 

Path is the pathname of a directory. Chdir causes this directory to become the current working 
directory, the starting point for path names not beginning with "/"• 

In order for a directory to become the current directory, a process must have execute (search) 
access to the directory. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned and 
enrno is set to indicate the error. 

ERRORS 

Chdir will fail and the current working directory will be unchanged if one or more of the following 
are true: 



|ENOTDIR| 

lENOENT] 

lENOENTl 

[EFERM] 

(EACCESI 

|E|fAULT) 

lELOOP] 

SEE ALSO 

chroot(2) 



A component of the pathname is not a directory. 

The named directory does not exist. 

The argument path name was too long. 

The argument contains a byte with the high-order bit set. 

Search permission is denied for any component of the path name. 

Path points outside the process's allocated address space. 

Too many symbolic links were encountered in translating the pathname. 



Sun Release 1.1 



Last change: 2 July 1083 



13 



CHMOD(2) SYSTEM CALLS CHMOD(2) 



NAME 

chmod, fchmod - change mode of file 

SYNOPSIS 

chmod(path, mode) 
char *path; 
int mode; 

fchmod(fdy mode) 
int fd, mode; 

DESCRIPTION 

The file whose name is given by path or referenced by the descriptor fd has its mode changed to 
mode. Modes are constructed by or'ing together some combination of the following: 

04000 set user ID on execution 

02000 set group ID on execution 

01000 save text image after execution 

00400 read by owner 

00200 write by owner 

00100 execute (search on directory) by owner 

00070 read, write, execute (search) by group 

00007 read, write, execute (search) by others 

If an executable file is set up for sharing (this u the default) then mode 1000 prevents the system 
from abandoning the swap-space image of the program-text portion of the file when its last user 
terminates. Ability to set this bit is restricted to the super-user. 

Only the owner of a file (or the super-user) may change the mode. 

Writing or changing the owner of a file turns off the set-user-id and set-group-id bits. Thb makes 
the system somewhat more secure by protecting set-user-id (set-group-id) files from remaining 
set-user-id (set-group-id) if they are modified, at the expense of a degree of compatibility. 

RETURN VALUE 

Upon successful completioil, a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the ei"ror. 

ERRORS 

Chmod will fail and the file mode will be unchanged if: 

(EPERM] The argument contains a byte with the high-order bit set. 

[ENOTDER] A component of the path prefix is not a directory. 

[ENOENT] The pathname was too long. 

jENOENT] The named file <loes not exist. 

(EACCES] Search permission is denied on a component of the path prefix. 

[EPERM] The effective user ID does not match the owner of the file and the effective user 

ID is not the super-user. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the process's allocated address space. 

[EL OOP] Too many symbolic links were encountered in translating the pathname. 

Fchmod will fail if: 

[EBADF] The descriptor is not valid. 

[EINVALJ Fd refers to a socket, not to a file. 

[EROFS] The file resides on a read-only file system. 
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SEE ALSO 

open(2), chown(2) 
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NAME 

chown, fchown - change owner and group of a file 

SYNOPSIS 

chown(path, owneF» group) 

char *path; 

Int owner, groupi 

fchown(fd» owner, group) 
Int fd, owner, group; 

DESCRIPTION 

The file which is named by path or referenced by fd has its owner and group changed as specified. 
Only the super^user may execute this call, because if users were able to give files away, they could 
defeat the file-space accounting procedures. 

Choxvn clears the set-user-id and set-group-id bits on the file to prevent accidental creation of set- 
user-id and set-group-id programs owned by the super-user. 

Fchown is particularly useful when used in conjunction with the file locking primitives (see 
flock{2)). 

Only one of the owner and group id's may be set by specifying the other as -1. 

RETURN VALUE 

Zero is returned if the operation was successful; -1 is returned if an error occurs, with a more 
specific error code being placed in the global variable errno. 

ERRORS 

Chown will fail and the file will be unchanged if: 

[EINVAL] The argument path does not refer to a file. 

(ENOTDIR) A component of the path prefix is not a directory. 

[ENOENT] The argument pathname is too long. 

[EPERM] The argument contains a oyte with the high-order bit set. 

(ENOENTl The named file does not exist. 

[EACCES] Search permission is denied on a component of the path prefix. 

[EPERM] The effective user ID does not match the owner of the file and the effective user 

ID is not the super-user. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the process's allocated address space. 

(EL OOP] Too many symbolic links were encountered in translating the pathname. 

Fchown will faii if: 

(EBADF] Fd does not refer to a valid descriptor. 

[EINVAL] Fd refers to a socket, not a file. 

SEE ALSO 

chmod(2), flock(2) 
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NAkE 

chroot - change root directory 

SYNOPSIS 

chroot(dlrname) 
char "'dlmam®! 

DESCRIPTION 

Dirname is the address of the pathname of a directory, terminated by a null byte. Chroot causes 
this directory to become the root directory, the starting point for path names beginning with "/". 
This root directory setting is inherited across execve{2) and by all children of this process created 
with fork{2) calls. 

In order for a directory to become the root directory a process must have execute (search) access 
to the directory. 

This call is restricted to the super-user. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate an error. 

ERRORS 

Chroot will fail and the root directory will be unchanged if one or more of the following are true: 

[ENOTDIR] A component of the path name is not a directory. 

The pathname was too long. 

The argument contains a byte with the high-order bit set. 

The named directory does not exist. 

Search permission is denied for any component of the path name. 

Path points outside the process's allocated address space. 

Too many symbolic links were encountered in translating the pathname. 



(ENOENTj 

[EPERMl 

(ENOENTJ 

[EACCES] 

(EFAULTj 

(ELOOPI 

SEE ALSO 

chdir(2) 
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NAME 

close - delete a descriptor 

SYNOPSIS 

clo8e(d) 
Int d; 

DESCRIPTION 

The close call deletes a descriptor from the per-process object reference table. K this is the last 
reference to the underlying object, then it will be deactivated. For example, on the last close of a 
file the current seek pointer associated with the file is lc»t; on the last close of a socket{2) associ- 
ated naming information and queued data are discarded; on the last close of a file holding an 
advisory lock the lock is released, see flock{2) for further information. 

A close of all of a process's descriptors is automatic on exit, but since there is a limit on the 
number of active descriptors per process, close is necessary for programs which deal with many 
descriptors. 

When a process forks (see fork{2)), all descriptors for the new child process reference the same 
objects as they did in the parent before the fork. If a new process is then to be run using 
execve(2), the process would normally inherit these descriptors. Most of the descriptors can be 
rearranged with dup2(2) or deleted with close before the execve is attempted, but if some of these 
descriptors will still be needed if the execve fails, it is necessary to arrange for them to be closed 
if the execve succeeds. For this reason, the call "fcnt^d, F^SETFD, 1)" is provided which 
arranges that a descriptor will be closed after a successful execve; the call "fcntl(d, F__SETFD, 0)" 
restores the default, which is to not close the descriptor. 

Close unmaps pages mapped through this file descriptor. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned and the 
global integer variable errno is set to indicate the error. 

ERRORS 

Oj^pse will fail if: 

[EBADF] D is not an active descriptor. 

SEE ALSO 

accept(2), flock(2), open(2), pipe(2), socket(2), 8ocketpair(2), execve(2), fcntl(2), mmap(2), mun- 
map(2) 
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NAME 

connect - initiate a connection on a socket 

SYNOPSIS 

#!nelude <eys/typs8.h> 

#l£iclii.de <6ys/Bocket.h> 

connect(8y name, nsmelen) 
Int 8} 

struct Boekaddr *name} 
int nameleni 

DESCRIPTION 

The parameter * is a socket. If it is of type SOCKJDGRAM, then this call permanently specifies 
the peer to which datagrams are to be sent; if it is of type SOCK_STREAM, then this call 
attempts to make a connection to another socket. The other socket is specified by name which is 
an address in the communications space of the socket. Each communications space interprets the 
name parameter in its own way. 

RETURN VALUE 

If the connection or binding succeeds, then is returned. Otherwise a -1 b returned, and a more 
specific error code b stored in errno. 

ERRORS 

The call fails if: 

(EBADF] 5 is not a valid descriptor. 

[ENOTSOCK] 5 is a descriptor for a file, not a socket. 

[EADDRNOTAVAIL| The specified address is not available on this machine. 

[EAFNOSUFPORT] Addresses in the specified address family cannot be used with this socket. 

[EISCONN] The socket is already connected. 

[ETIMEDOUT] Connection establishment timed out without establishing a connection. 

[ECONNREFUSED] The attempt to connect was forcefully rejected. 

[ENETUNREACH] The network isn't reachable from this host. 

[EADDRINUSE] The address is already in use. 

[EFAULT] The name parameter specifies an area outside the process address space. 

[EWOULDBLOCK] The socket is non-blocking and the and the connection cannot be com- 
pleted immediately. It is possible to 9eUct{2) the socket while it is con- 
necting by selecting it for writing. 

SEE ALSO 

accept(2), 8elect(2), socket(2), getsockname(2) 
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NAME 

creat - create a new file 

SYNOPSIS 

creat(name, mode) 
char *name; 

DESCRIPTION 

This interface Is obsoleted by open(2). 

Creat creates a new file or prepues to rewrite an exbting file called name, given as the address of 
a null-terminated string. If the file did not exist, it is given mode mode, as modified by the 
process's mode mask (see uma8k{2)). Also see chmod{2) for the construction of the mode argu- 
ment. 

If the file did exist, its mode and owner remain unchanged but it is truncated to length. 

The file is also opened for writing, and its file descriptor is returned. 

NOTES 

The mode given is arbitrary; it need not allow writing. This feature has been used in the past by 
programs to construct a simple exclusive locking mechanism. It is replaced by the 0_EXGL open 
n^pde, or flock{2) facilitity. 

RETURN VALUE 

The value -1 is returned if an error occurs. Otherwise, the call returns a non-negative descriptor 
which only permits writing. 

ERRORS 

Creat will fail and the file will not be created or truncated if one of the following occur: 

[EPERM] The argument contains a byte with the high-order bit set. 

[ENOTDIR] A component of the path prefix is not a directory. 

[EACCES] A needed directory does not have search permission. 

[EACCES] The file does not exist and the directory in which it is to be created is not writ- 

able. 

[EACCES] The file exists, but it is unwritable. 

(EISDIR] The file is a directory. 

[EMFILE] There are already too many files open. 

[EROFS] The named file resides on a read-only file system. 

[ENXIOJ The file is a character special or block special file, and the associated device does 

not exist. 

(ETXTBSY) The file is a pure procedure (shared text) file that is being executed. 

[EFAULT] Name points outside the process's allocated address space. 

[ELOOPJ Too many symbolic links were encountered in translating the pathname. 

lEOPNOTSLTpPj 

The file was a socket (not currently implemented). 

SEE ALSO 

open(2), write(2), close(2), chmod(2), umask(2) 
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NAME 

dup, dup2 - duplicate a descriptor 

SYNOPSIS 

newd sss dup(oldd) 
Int oewdf oidd) 

dup2(oldd, newd) 
Int oIdd, newd; 

DESCRIPTION 

Dup duplicates an existing object descriptor. The argument oldi is a small non-negative integer 
index in the per-process descriptor table. The value must be less than the size of the table, which 
is returned by getdtahle8ize{2). The new descriptor ntwd returned by the call is the lowest num- 
bered descriptor which is not currently in use by the process. 

The object referenced by the descriptor does not distinguish between references using oldd and 
newd in any way. Thus if ntwd and oldd are duplicate references to an open file, read{2), wr%te{2) 
and l8eek{2) calls all move a single pointer into the file. If a separate pointer into the file is 
desired, a different object reference to the file must be obtained by issuing an additional open{2) 
call. 

In the second form of the call, the value of ntwd desired is specified. If this descriptor is already 
in use, the descriptor is first deallocated as if a clo8t{2) call had been done first. 

RETURN VALUE 

The value -1 is returned if an error occurs in either call. The external variable trrno indicates 
the cause of the error. 

ERRORS 

Dup and dupS fail if: 

[EBADF] Oldd or newd is not a valid active descriptor 

[EMFILE] Too many descriptors are active. 

SEE ALSO 

accept(2), open(2), close(2), pipe(2), socket(2), socketpair(2), getdtablesize(2) 
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NAME 

execve - execute a file 

SYNOPSIS 

execve(naine, argV| envp) 
char *name, *argv[], *envpQ; 

DESCRIPTION 

Execve transforms the calling process into a new process. The new process is constructed from an 
ordinary file called the new procegs fiie. This file is either an executable object file, or a file of 
data for an interpreter. An executable object file consists of an identifying header, followed by 
pages of data representing the initial program (text) and initialized data pages. Additional pages 
may be specified by the header to be initialize with zero data. See a.otit{h). 

An interpreter file begins with a line of the form ''#! interpreted* \ When an interpreter file is 
execve 'd, the system execve 's the specified interpreter, giving it the name of the originally exec'd 
file as an argument, shifting over the rest of the original arguments. 

There can be no return from a successful execve because the calling core image is lost. This is the 
mechanism whereby different process images become active. 

The argumeiii atgv is an array of character pointers to null-terminated character strings. These 
strings constitute the argument list to be made available to the new process. By convention, at 
least one argument must be present in this array, and the first element of this array should be the 
name of the executed program (i.e. the last component of name). 

The argument envp is also an array of character pointers to null-terminated strings. These strings 
pass information to the new process which are not directly arguments to the command, see 
environ{h). 

Descriptors open in the calling process remain open in the new process, except for those for which 
the close-on-exec flag is set; see clo9e[2). Descriptors which remain open are unaffected by execve. 

Ignored signab remain ignored across an execve, but signals that are caught are reset to their 
default values. The signal stack is reset to be undefined; see rigvec{2) for more information. 

Each process has a real user ID and group ID and an effective user ID and group ID. The real ID 
identifies the person using the system; the effective ID determines his access privileges. Execve 
changes the effective user and group ID to the owner of the executed file if the file has the "set- 
user-ID" or "set*group-ID" modes. The rea/ user ID is not affected. 

The new process also inherits the following attributes from the calling process: 

proce&s IB see getpid{2) 

parent process ID see getppid{^ 

process group ID see getpgrp(2) 

access groups see getgroupt[2) 

working directory see cArf»r(2) 

root directory see chroot{2) 

control terminal see tty{A) 

resource usages see getruBage{2) 

interval timers see getitimer{2) 

resource limits see getrlimit{2) 

file mode mask see uma9it(2) 

signal mask see 8igvec{2) 

When the executed program begins, it is called as follows: 

main(argc, argv, envp) 

int argc; 

char **argv, **envp; 
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where arge is the number of elements in argv (the "arg count") and argv is the array of character 
pointers to the arguments themselves. 

Envp is a pointer to an array of strings that constitute the environment of the process. A pointer 
to this array is ako stored in the global variable "environ". Each string consists of a name, an 
"ss", and a null-terminated value. The array of pointers is terminated by a null pointer. The 
shell 8h(l) passes an environment entry for each global shell variable defined when the program is 
called. See environ{5) for some conventionally used names. 

RETURN VALUE 

If execve returns to the calling process an error has occurred; the return value will be -1 and the 
global variable errno will contain an error code. 

ERRORS 

Execve will fail and return to the calling process if one or more of the following are true: 

[ENOENT] One or more components of the new process file's path name do not exist. 

[ENOTDIR] A component of the new process file is not a directory. 

[EACCES] Search permission is denied for a directory listed in the new process file's path 

prefix. 

[EACCES] The new process file is not an ordinary file. 

[EACCES] The new process file mode denies execute permission. 

[ENOEXEC] The new process file has the appropriate access permission, but has an invalid 
magic number in its header. 

[E)TXTBSY] The new process file is a pure procedure (shared text) file that is currently open 
for writing or reading by some process. 

[ENOMEM] The new process requires more virtual memory than is allowed by the imposed 
maximum {getrHmit{2)). 

[E2BIG] The number of bytes in the new process's argument list is larger than the 

system-imposed limit of {ARGJMAX} bytes. 

[EFAULT] The new process file is not as long as indicated by the size values in its header. 

[EFAULT] Path , argv, or envp point to an illegal address. 

CAVEATS 

If a program is eetuid to A non-super-user, but is executed when the real uid is "root", then the 
program has the powers of a super-user as well. 

SEE ALSO 

exit(2), fork(2), cxecl(3), environ(S) 
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NAME 

jexit - terminate a process 

SYNOPSIS 

_exlt(8tatus) 
int ttatuB) 

DESORIfTION 

_jxit terminates a process with the following consequisnces: 

All of the descriptors open in the calling process are closed. 

If the parent process of the calling process is executing a wait or is interested in the SIGCHLD 
signal, then it is notified of the calling process's termination and the low-order eight bits of status 
are made available to it; see wait(2). The low-order 8 bits of status are available to the parent 
process. 

The parent process tb of all of the calling process's existing child processes are also set to 1. This 
means that the initialization process (see intro(2)) inherits each of these processes as well. 

Most C programs will call the library routine exit{2) which performs cleanup actions in the stan- 
dard i/o library before calling ^ent. 

RETURN VALUE 

This call never returns. 

SEE ALSO 

fork(2), wait(2), exit(3) 
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NAME 

fcnt! - file control 

SYNOPSIS 

#laclude <feiitl.h> 

res ss fci&tl(fdf emd, arg) 

Int res; 

hit td, cmd, arg) 

DESCRIPTION 

Fcntl provides for control over descriptors. The argument fd is a descriptor to be operated on by 
cmd as follows: 

Return a new descriptor as follows: 

Lowest numbered available descriptor greater than or equal to arg. 

Same object references as the original descriptor. 

New descriptor shares the same file pointer if the object was a file. 

Same access mode (read, write or read/write). 

Same file status flags (i.e., both file descriptors share the same file status flags). 

The close-on-exec flag associated with the new file descriptor is set to remain 
open across execve{2) system calls. 

Get the close-on-exec fiag associated with the file descriptor fd. If the low-order 
bit is 0, the file will remain open across exec, otherwise the file will be closed 
upon execution of exec. 

Set the close-on-exec flag associated with fd to the low order bit of arg (0 or 1 as 
above). 

Get descriptor status flags, see fcnU{5) for their definitions. 

Set descriptor status flags, see fcnU{5) for their definitions. 

Get the process ID or process group currently receiving SIGIO and SIGURG sig- 
nals; process groups are returned as negative values. 

Set the process or process group to receive SIGIO and SIGURG signals; process 
groups are specified by supplying arg as negative, otherwise arg is interpreted as 
a process ID. 

The SIGIO facilities are enabled by setting the FASYNC fiag with F_SETFL. 

RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 

F_PUPfB a new file descriptor. 

Value of flag (only the low-order bit is deflned). 

Value of flags. 

Value of file descriptor owner. 

Value other than -1. 

Otherwise, a value of -lb returned and errno is set to indicate the error. 

ERRORS 

Fcntl will fail if one or more of the following are true: 

[EBADF] FUdes is not a valid open file descriptor. 

(EMFILEJ Cmrf is FJDUPFD and the maximum allowed number of file descriptors are 

currently open. 



F„GETFD 

F^SETFD 

F^GETFL 
F„SETFL 
F_GETOWN 

F SETOWN 



F.GETFD 

f_getfL 

F.GETOWN 
other 
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[EINVAL] Cmd is F_DUPFD and arg is negative or greater the maximuni allowable number 

(see getdtabte8ize(2)). 

SEE ALSO 

close(2), execve(2), getdtablesize(2), open(2), 8igvec(2) 
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flock - apply or remove an advisory lock on an open file 

SYNOPSIS 

#lse!ude <8y8/flle.h> 

#d©Sii® LOCK^SH 1 /* shared lock */ 

#deSsie LOGK.EX 2 /* exclusive lock */ 

#defiiie LOGK.NB 4 /* don't block when lockhig */ 

#deSne LOCK_UN 8 /* unlock */ 

||ock(fd, operation) 
Ipt fd{, o| 



DESOEIFTION 

Fbck applies or removes an advisory lock on the file associated with the file descriptor fd. A lock 
is applied by specifying an operation parameter which is the inclusive or of LOCK_SH or 
LOCKJEX and, possibly, LOCK_NB. To unlock an existing lock operation should be 

LOCK_UN, 

Advisory locks allow cooperating processes to perform consistent operations on files, but do not 
guarantee consistency (i.e. processes may still access files without using advisory locks possibly 
resulting in inconsistencies). 

The locking mechanism allows two types of locks: shared locks and ezclusive locks. At any time 
multiple shared locks may be applied to a file, but at no time are multiple exclusive, or both 
shared and exclusive, locks allowed simultaneously on a file. 

A shared lock may be upgraded to an exclusive lock, and vice versa, simply by specifying the 
appropriate lock type; this results in the previous lock being released and the new lock applied 
(possibly after other processes have g^ned and released the lock). 

Requesting a lock on an object which is already locked normally causes the caller to blocked until 
the lock may be acquired. If LOCK_NB is included in operation, then this will not happen; 
instead the call will fail and the error EWOULDBLOCK will be returned. 

NOTES 

L<K;ks are on files, not file descriptors. That is, file descriptors duplicated through dup{2) or 
fork(2) do not result in multiple instances of a lock, but rather multiple references to a single 
lock. If a process holding a lock on a file forks and the child explicitly unlocks the file, the parent 
will lose its locki 

Processes blocked awaiting a lock may be awakened by signals. 

RETURN VALUE 

Zero is returned if the operation was successful; on an error a -1 is returned and an error code is 
left in the global location errno. 

ERRORS 

The flock call faib if: 

[EWOULDBLOCK) The file is locked and the LOCK_NB option was specified. 
[EBADF] The argument fd is an invalid descriptor. 

[EINVAL] The argument fd refers to an object other than a file. 

SEE ALSO 

open(2), close(2), dup(2), execve(2), fork(2) 
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NAME 

fork - create a new process 

SYNOPSIS 

pid = forkO 
int pid} 

DESCRIPTION 

Fork causes creation of a new process. The new process (child process) is an exact copy of the 
calling process except for the following: 

The child process has a unique process ID. 

The child process has a different parent process ID (i.e., the process ID of the parent pro- 
cess). 

The child process has its own copy of the parent's descriptors. These descriptors reference 
the same underlying objects, so that, for instance, file pointers in file objects are shared 
between the child and the parent, so that a l8eek{2) on a descriptor in the child process can 
affect a subsequent read or write by the parent. This descriptor copying is also used by the 
shell to establish standard input and output for newly created processes as well as to set up 
pipes. 

The child processes resource utilizations are set to 0; see 8etrtimit{2). 

RETURN VALUE 

Upon successful completion, fork returns a value of to the child process and returns the process 
ID of the child process to the parent process. Otherwise, a value of -1 is returned to the parent 
process, no child process is created, and the global variable errno is set to indicate the error. 

ERRORS 

Fork will fail and no child process will be created if one or more of the following are true: 

(EAGAIN] The system-imposed limit {PROC_MAX} on the total number of processes 

under execution would be exceeded. 

[EAGAIN] The system-imposed limit {KID_MAX} on the total number of processes under 

execution by a single user would be exceeded. 

SEE ALSO 

execve(2), wait(2) 
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NAME 

fsync - synchronize a file's in-core state with that on disk 

SYNOPSIS 

fBync(fd) 
Intfd; 

DESCRIPTION 

Fsync causes all modified data and attributes of fd to be moved to a permanent storage device: all 
in-core modified copies of buffers for the associated file have been written to a disk when the call 
returns. (Note that this is different than 8ync(2) which schedules disk-io for all files (as though an 
faync had been done on all files) but returns before the i/o completes.) 

Feyne should be used by programs which require a file to be in a known state; for example in 
building a simple transaction facility. 

RETURN VALUE 

A value is returned on success. A -1 value indicates an error. 

ERRORS 

The fsync fails if: 

jEPADF] Fd is not a valid descriptor. 

[Bf|NVAL| Fd refers to a socket, not to a file. 

SEE ALSO 

sync(2), sync(8), cron(8) 

BUGS 

The current implementation of this call is expensive for large files. 
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NAME 

getdtablesize - get descriptor table size 

SYNOPSIS 

nds s= getdtablesiseO 
Int nds; 

DESCRIPTION 

Each process has a fixed size descriptor table which is guaranteed to have at least 20 slots. The 
entries in the descriptor table are numbered with small integers starting at 0. The call getdta- 
blesize returns the size of this table. 

SEE ALSO 

ciose(2), dup(2), open(2) 
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getgid, getegid - get group identity 
SYNOPSIS 



iBt gld; 

egld 5= getegld() 
Int egld} 

DESOEIPTION 

Getgid returns the real group ID of the current process, getegid the effective group ID. 

The real group ID is specified at login time. 

The effective group ID is more transient, and determines additional access permission during exe- 
cution of a "set-group-ID^' process, and it is for such processes that getgid is most useful. 

SEE ALSO 

getuid(2), setregid(2), 8etgid(3C) 
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NAME 

getgroups - get group access list 

SYNOPSIS 

#iiiclude <By8/param.h> 

ngroups = getgroup8(ii» ftgidset) 
int ngroups; 
Int n, *gidset; 

DESCRIPTION 

Getgroups gets the current group access list of the user process and stores it in the array gidset. 
The parameter n indicates the number of entries which may be placed in gidaet and getgroups 
returns the actual number of entries placed in the gidset array. No more than NGRPS, as defined 
in <8y8/param.h>, will ever be returned. 

RETURN VALUE 

A return value of greater than zero indicates the number of entries placed in the gidset array. A 
return value of -1 indicates that an error occurred, and the error code is stored in the global vari- 
able errno. 

ERRORS 

The possible errors for get group are: 

[EFAULT] The arguments ngroups or gidset specify invalid addresses. 

SEE ALSO 

se|group8(2), initgroup8(3) 
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gethostid - get unique identifier of current host 

SYNOPSIS 

kostld =s gethostidQ 

iut hostid; 

DESCRIPTION 

Gethostid returns the 32-bit identifier for the current host, which is unique across all hosts. 

SEE ALSO 

hostid (1) 
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NAME 

gethostname, sethostname - get/set name of current host 

SYNOPSIS 

gethoBtname(name» namelen) 
char *naine; 
int namelen) 

8ethoBtname(name, namelen) 
char *name{ 
int namelen; 

DESCRIPTION 

Gethostname returns the standard host name for the current processor, as previously set by 
sethostname. The parameter namelen specifies the size of the name array. The returned name is 
null-terminated unless insufficient space is provided. 

Sethostname sets the name of the host machine to be name, which has length namelen. This call 
is restricted to the super-user and is normally used only when the system is bootstrapped. 

RETURN VALUE 

If the call succeeds a value of is returned. If the call fails, then a value of -1 is returned and an 
error code is placed int the global location errno. 

ERRORS 

The following errors may be returned by these calk: 

[EFAULT] The name or namelen parameter gave an invalid address. 

[EPERM] The caller was not the super-user. 

SEE ALSO 

getho8tid(2) 

BUGS 

Host names are limited to 255 characters. 
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NAME 

getitimer, setitimer - get/set value of interval timer 

SYNOPSIS 

#lQe!ud® <sys/tinse.h> 

#d©to@ ITIMER_REAL /♦ real time intervals */ 

#deSne ITIMER_VIRTUAL 1 /* virtual time Intervals */ 

#d@^Ei9 ITIMEE.PROF 2 j* user and system virtual time */ 

getitlmer(whiehy value) 

int whlehi 

struct itlmerval '^valuei 

8etltlmer(which, valuCf ovalue) 

int whlchi 

struct itimerval *value, *ovalue; 

DESCRIPTION 

The system provides each process with three interval timers, defined in <8y8ltime.h>. The geti- 
timer call returns the current value for the timer specified in which, while the setitimer call sets 
the value of a timer (optionally returning the previous value of the timer). 

A timer value is defined by the itimerval structure: 

struct itimerval { 

struct timeval itjnterval; /* timer interval */ 
struct timeval it value; /* current value */ 

}; 

If itjoalue is non-zero, it indicates the time to the next timer expiration. If it_interval is non-zero, 
it specifies a value to be used in reloading itjualue when the timer expires. Setting itjualue to 
disables a timer. Setting it_interval to causes a timer to be disabled after its next expiration 
(assuming itjvalue is non-zero). 

Time values smaller tfian the resolution of the system clock are rounded up to this resolution. 

The ITIMERJREAL timer decrements in real time. A SIGALRM signal is delivered when this 
timer expires. 

The ITIKlfcR_yiRTUAL timer decrements in process virtual time. It runs only when the process 
is executing. A SIGVTALRM signal is delivered when it expires. 

The ITIMEk_PROF timer decrements both in process virtual time and when the system is run- 
ning on behalf of the process. It is designed to be used by interpreters in statistically profiling the 
execution of interpreted programs. Each time the ITIMER_PROF timer expires, the SIGPROF 
signal is delivered. Because this signal may interrupt in-progress system calls, programs using this 
timer must be prepared to restart interrupted system calls. 

NOTES 

Three macros for manipulating time values are defined in <sy8/time.h>. Timerclear sets a time 
value to zero, timerisset tests if a time value is non-zero, and timercmp compares two time values 
(beware that >= aured <— do not work with this macro). 

RETURN VALUE 

If the calls succeed, iat value of is returned. If an error occurs, the value -1 is returned, and a 
more precise error code is placed in the global variable errno. 

ERRORS 

The possible errors are: 

[EFAULT] The value structure specified a bad address. 
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[EINVAL] A value structure specified a time was too large to be handled. 

SEE ALSO 

sigvec(2), gettimeofday(2) 
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NAME 

getpagesize - get system page size 

SYNOPSIS 

p&geslse s= getpag^IseO 

ii^t pag^ls®! 

DESCRIPTION 

Getpagesize returns the number of bytes in a page. Page granularity is the granularity of many of 
the memory management calls. 

The page size is a system page size and may not be the same as the underlying hardware page 
size. 

SEE ALSO 

sbrk(2), pagesize(l) 
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NAME 

getpeername - get name of connected peer 

SYNOPSIS 

getpeername(8y name, namelen) 

Int 8) 

struct Bockaddr "'namei 

int *nameleii; 

DESCRIPTION 

Getpeername returns the name of the peer connected to socket s. The namelen parameter should 
be initialized to indicate the amount of space pointed to by name. On return it contains the 
actual size of the name returned (in bytes). 

DIAGNOSTICS 

A is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EBADF] The argument e is not a valid descriptor. 

[ENOTSOCKJ The argument » is a file, not a socket. 

[ENOTCONN] The socket is not connected. 

[ENOBUFS] Insufficient resources were available in the system to perform the operation. 

[EFAULT] The name parameter points to memory not in a valid part of the process address 

space. 

SEE ALSO 

bind(2), socket(2), getsockname(2) 

BUGS 

Names bound to sockets in the UNIX domain are inaccessible; getpeername returns a zero length 
name. 
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NAME 

getpgrp - get process group 

SYNOPSIS 

pgrp =s getpgrp(pld) 
Int prgp; 
Int pid; 

DESCRIPTION 

The process group of the specified process is returned by getpgrp. If pid is zero, then the call 
applies to the current process. 

Process groups are used for distribution of signals, and by terminals to arbitrate requests for their 
input: processes which have the same process group as the terminal are foreground and may read, 
while others will block with a signal if they attempt to read. 

This call is thus used by programs such as C8h{l) to create process groups in implementing job 
control. The TIOCGPGRP and TIOCSPGRP calk described in tty{4) are used to get/set the 
process group of the control terminal. 

SEE ALSO 

8etpgrp(2), getuid(2), tty(4) 
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NAME 

getpid, getppid - get process identification 

SYNOPSIS 

pld = getpidO 
long pid| 

ppid =s getppld() 
long ppId; 

DESCRIPTION 

Getpid returns the process ID of the current process. Most often it is used with the host identifier 
getho8tid{2) to generate uniquely-named temporary files. 

Getppid returns the process ID of the parent of the current process. 

SEE ALSO 

gethostid(2) 
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NAME 

getpriority, setpriority - get/set program scheduling priority 

SYNOPSIS 

#liieliid@ <8ys/re8ource.h> 

#d®fliae PRIO^FROCESS /* process */ 

#deSiie PRIO_PGRP 1 /* process group */ 

#deto9 PRIO„USER 2 /* user id */ 

pr!o s=B getpr!orlty(whlchp who) 

int prio; which; whop 

@etprlorlty(whlch; who, prio) 

Int which, whoy prIo; 

DESCRIPTION 

The scheduling priority of the process, process group, or user, as indicated by which and who is 
obtained with the getpriority call and set with the setpriority call. Which is one of 
PRIO_PROCESS, PRIOJPGRP, or PRIO_USER, and who is interpreted relative to which (a pro- 
cess identifier for PRIO_PROCESS, process group identifier for PRIO_PGRP, and a user ID for 
PRIO_USER). Prio is a value in the range -20 to 20. The default priority is 0; lower priorities 
cause more favorable scheduling. 

The getpriority call returns the highest priority (lowest numerical value) enjoyed by any of the 
specified processes. The setpriority call sets the priorities of all of the specified processes to the 
specified value. Only the super-user may lower priorities. 

RETURN VALUE 

Since getpriority can legitimately return the value -1, it is necessary to clear the external variable 
errno prior to the call, then check it afterward to determine if a -1 is an error or a legitimate 
value. The setpriority call returns if there is no error, or -1 if there is. 

ERRORS 

Getpriority and setpriority may return one of the following errors: 

[ESRCH] No process(es) were located using the which and who values specified. 

jEINVAL) Which was not one of PRIOJPROCESS, PRIO.PGRP, or PRIO.USER. 

In addition to the errors indicated above, setpriority may fail with one of the following errors 
returned: 

fEACCES] A process was located, but neither its eflfective nor reaJ user ID matched the 

effective user ID of the caller. 

jEACCES] A non super-user attempted to change a process priority to a negative value. 

SEE ALSO 

nice(l), fork(2), renice(8) 

BUGS 

It is not possible for the process executing setpriority ( ) io lower any other process down to its 
current priority, without requiring superuser privileges. 
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NAME 

getrlimit, setrlimit - control maximum system resource consumption 

SYNOPSIS 

#include <By8/time.h> 
#inelude <8y8/re80urce.h> 

getrliinlt(re80urcef rip) 
Int resource} 
struct rllmlt *rlp| 

Betrliinlt(re80urce, rip) 
int resourcei 
struct rllmit *rlp) 

DESCRIPTION 

Limits on the consumption of system resources by the current process and each process it creates 
may be obtained with the getrlimit call, and set with the setrlimit call. 

The resource parameter is one of the following: 

RLIMIT_CPU the maximum amount of cpu time (in milliseconds) to be used by each pro- 
cess. 

RLIMIT_FSIZE the largest size, in bytes, of any single file which may be created. 

RLIMIT_DATA the maximum size, in bytes, of the data segment for a process; this defines 
how far a program may extend its break with the shrk{2)syatemca\\. 

RLINflT_STACK the maximum size, in bytes, of the stack segment for a process; this defines 
how far a program's stack segment may be extended automatically by the sys- 
tem. 

RLIMIT_CORE the largest size, in bytes, of a core file which may be created. 

RLIMITJRSS the maximum size, in bytes, a process's resident set size may grow to. This 
imposes a limit on the amount of physical memory to be given to a process; if 
memory is tight, the system will prefer to take memory from processes which 
are exceeding their declared resident set size. 

A resource limit is specified as a soft limit and a hard limit. When a soft limit is exceeded a pro- 
cess may receive a signal (for example, if the cpu time is exceeded), but it will be allowed to con- 
tinue execution until it reaches the hard limit (or mddifies its resource limit). The rlimit structure 
is used to specify the hard and soft limits on a resource, 

struct rlimit { 

int rlim_cur; /* current (soft) limit */ 

int rlim max; /* hard limit */ 

}; 

Only the super-user may rafee the maximum limits. Other users may only alter rUm_cur within 
the range from to r/tm_moaf or (irreversibly) lower rlim_max. 

An "infinite" Value for a limit is defined as RLIMITJNFINITY (QxTfffffff). 

Because this information is stored in the per-process information, this system call must be exe- 
cuted directly by the shell if it is to affect all future processes created by the shell; limit is thus a 
built-in command to C8h(l). 

The system refuses to extend the data or stack space when the limits would be exceeded in the 
normal way: a break call fails if the data space limit b reached, or the process is killed when the 
stack limit is reached (since the stack cannot be extended, there is no way to send a signal!). 



42 Last change: 29 August 1983 Sun Release 1.1 



GETRLIMIT(2) SYSTEM CALLS GETRLIMIT(2) 



A file i/o operation which would create a file which is too large wilt cause a signal SIGXFSZ to be 
generated, this normally terminates the process,^ but may be caught. When the soft cpu time 
limit is exceeded^ a signal SIGXCPU is sent to the offending process. 

RETURN VALUE 

A return value indicates that the call succeeded, changing or returning the resource limit. A 
return value of -1 indicates that an error occurred, and an error code is stored in the global locar 
tiott errno. 

ERRORS 

The possible errors ster 

[EFAULT] The address specified for dp is invalid. 

[EPEHM| The Hmit specified to eefrlimit would have 

raised the maximum limit valtie,. and the caller is not the super-user. 

SEE ALSO 

esh(l^ quota(2) 

BUGS 

There should be limit snd unlimit commands tn «A(1) as wetl as in esh. 
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NAME 



getrusage— get information about resource utilization 



/* callUig process */ 

/'" terminated child processes */ 



SYNOPSIS 

#include <sys/time.h> 
#Liclude <sys/resouree^> 

#deflne RUSAGELSELr 

#define RUSAGE JZIiniiDEEN -1 

getrus&ge(who, rusage) 

int who; 

struct rusage *rusagef 

DESCRIPTION 

Getrusage returns information about the resources utilized by the current process, or adll its ter- 
minated child processes. The who parameter is one of RUSAGEJSELF or 
RUS AGE_GHILDREN. If ruaage is non-zero, the buffer it points to will be Med in with the fol^ 
lowing structure: 

usaee I 

/* user time used */ 
/* system time used */ 

/* integral shared memory size */ 

/*integral/unshared data size */ 

/* integral unshwed stack size */ 

/* page reclaims */ 

/♦page faults */ 

/♦swaps*/ 

/* block input operations */ 

/* block output operations */ 

/* messages sent */ 

/♦ messages received */ 

/* signak received */ 

/* voluntary context switches */ 

/* involuntaiy context switches */ 

The fields are interpreted as follows: 

ru_utime the total amount of time spent executing in user mode. Time is given in 

8econd8:microseconds. 

the total amount of time spent in the system executing on behalf of the 
proces8(es). Time is given in secondsrmicroseconds. 

the maximum resident set size utilized. Size is given in pages (1 page = 
2Kbytes). 

an 'Untegral" value indicating the amount of memoiy used which was also 
shared among other processes. This vaJue is expressed in units of pages ♦ clock 
ticks (1 tick =s 1/50 second). The vaJue is calculated by summing the number of 
shaaped memory pages in use each time the internal system clock ticks, and then 
averaging over 1 second intervals. 

an integral value of the s^nount of unshared memory residing in the data seg- 
ment of a process. The value is given in pages * clock ticks. 

an integral value of the amount of unshared memory residing in the stack seg- 
ment of a process. The value is given in pages ♦ clock ticks. 



struct rusage 


{ 


struct timeval ru_utime; 


struct timeval rujstime; 


int 


ru_maxrss; 


int 


ru_ixr88; 


int 


rujdrss; 


int 


rujsrss; 


int 


rujminflt; 


int 


ru.jnajflt; 


int 


rujDswap; 


int 


rujnblock; 


int 


rujoublock; 


int 


ru_msgsnd; 


int 


ru^msgrcv; 


int 


rujnsignals; 


int 


ru_nvcsw; 


int 


ru_nivcsw; 



ru stime 



ru m^crss 



ru ixrss 



ru idrss 



ru isrss 



44 



Last change: 20 February 1984 



Sun Release l.I 



GETRUSAGE(2) 



SYSTEM CALLS 



GETRUSAGE(2) 



rw_mmflt 

ru_majflt 

ru_nswap 

ni_inb!ock 

ru_outblock 

ru_msgsnd 

rujmsgrcv 

ru.nsignals 

ru_,nvc8w 

runivcsw 



the number of page faults serviced without any i/o activity; here i/o activity is 
avoided by "reclaiming" a page frame from the list of pages awaiting reallocar 
tion. 

the number of page faults serviced which required i/o activity. 

the number of times a process was "swapped" out of main memory. 

the number of times the file system had to perform input. 

the number of times the file system had to perform output. 

the number of ipc messages sent. 

the number of ipc messages received. 

the number of signals delivered. 

the number of times a context switch resulted due to a process voluntarily giving 
up the processor before its time slice was completed (usually to await availability 
of a resource). 

the number of times a context switch resulted due to a higher priority process 
becoming runnable or because the current process exceeded its time slice. 



NOTES 



The numbers ru_inblock and ru__outblock account onfy for real i/o; data supplied by the cacheing 
mechanism is charged only to the first process to read or write the data. 

SEE ALSO 

gettimeofday(2), wait(2) 

BUGS 

There is no way to obtain information about a child process which has not yet terminated. 
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NAME 

getsockname - get socket name 

SYNOPSIS 

get8ockname(S| name, namelen) 

Int b; 

struct Bockaddr *name) 

int *namelen; 

DESCRIPTION 

Getsockname returns the current name for the specified socket. The namelen parameter should be 
iltitialized to indicate the amount of space pointed to by name. On return it contains the actual 
size of the name returned (in bytes). 

DIAGNOSTICS 

A is returned if the ^zH succeeds, -1 if it faib. 

ERRORS 

The call succeeds unless: 

[EBADF] The argument a is not a valid descriptor. 

lENOTSOCKl The argument « is a file, not a socket. 

[ENOBUFS] Insufficient resources were available in the system to perform the operation. 

[EFAULT] The name parameter points to memory not in a valid part of the process address 

space. 

SEE ALSO 

bind(2), socket(2), getpeername(2) 

BUGS 

Names bound to sockets in the UNIX domain are inaccessible; getaockname returns a zero length 
name. 
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NAME 

getsockopt, setsockopt - get and set options on sockets 

SYNOPSIS 

#liseliad@ <gys/type8.h> 
#liielud@ <eys/soeket.li> 

get8oekopt(s, level, optname; optval, optlen) 
Int 8, level, optusme} 
ch&w *optval| 
Int "^optleni 

8et8oekopt(s, level, optname, optval, optlen) 

Int s, level, optnamei 
char "^optvalp 
Int optleni 

DESCRIPTION 

Getsoekopt and sttsockopt manipulate options associated with a socket. Options may exist at 
multiple protocol levels; they are always present at the uppermost "socket" level. 

When manipulating socket options the level at which the option resides and the name of the 
option must be speci@ed. To manipulate options at the "socket" level, level is specified as 
SOL_SOCKET. To manipulate options at any other level the protocol number of the appropriate 
protocol controlling the option is supplied. For example, to indicate an option is to be inter- 
preted by the TCP protocol, level should be set to the protocol number of TCP; see 
getprotoent{ZN). 

The parameters optval and optlen are used to access option values for setsockopt. For getsockopt 
they identify a bufiTer in which the value for the requested option(s) are to be returned. For get- 
sockopt, optlen is a value-result parameter, initially containing the size of the buffer pointed to by 
optval, and modified on return to indicate the actual size of the value returned. If no option 
value is to be supplied or returned, optval may be supplied as 0. 

Optname and any specified options are passed uninterpreted to the appropriate protocol module 
for interpretation. The include file < sys J socket. h> contains definitions for "socket" level 
options; see socket{2). Options at other protocol levels vary in format and name, consult the 
appropriate entries in (4P). 

RETURN VALUE 

A is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

jEBADF] The argument s is not a valid descriptor. 

[ENOTSOCK] The argument 9 is a file, not a socket. 

(ENOPROTOOPT) The option is unknown. 

(EFAULT) The options are not in a valid part of the process address space. 

SEE ALSO 

socket(2), getprotoent(3K) 
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NAME 

gettimeofday, settimeofday - get/set date and time 

SYNOPSIS 

#iixclude <sy8/time.h> 

gettimeofday(tp, tsp) 
struct timeval *tp{ 
struct timesone *tsp} 

settimeofday (tpt tsp) 
struct timeval *tp{ 
struct timesone *tsp) 

DESCRIPTION 

Gettimeofday returns the system's notion of the current Greenwich time and the current time 
zone. Time returned is expressed in seconds and microseconds since midnight January I, 1970. 

The structures pointed to by tp and tzp are defined in <8y8/time.k> as: 

struct timeval { 

ujong tv_sec; /* seconds since Jan. 1, 1970 */ 

long tv_usec; /* and microseconds */ 

}; 

struct timezone { 

int tz_minuteswest; /* of Greenwich */ 

int tz_d8ttime; /* type of dst correction to apply */ 

}; 

The timezone atTuctnte indicates the local time zone (measured in minutes of time westward from 
Greenwich), and a flag that, if nonzero, indicates that Daylight Saving time applies locally during 
the appropriate part of the year. 

If |p and/or tzp is a zero pointer, the corresponding information will not be returned or set. 

Only the super-user may set the time of day. 

RETURN 

A p return value indicates that the call succeeded. A -1 return value indicates an error occurred, 
and in this case an error code is stored into the global variable errno. 

ERRORS 

The following error codes may be set in errno: 

[EFAULT] An argument address referenced invalid memory. 

[EPERN^ A user other than the super-user attempted to set the time. 

SEE ALSO 

date(l), ctime(3) 

BUGS 

Time is never correct enough to believe the microsecond values. There should a mechanism by 
which, at least, local clusters of systems might synchronize their clocks to millisecond granularity. 
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NAME 

getuid, geteuid - get user identity 

SYNOPSIS 

uld ss getuidQ 
Int uldf 

eutd ^ geteuid() 
Int euld) 

DESCRIPTION 

^^tuid returns the real user ID of tbe current process, geteuid the effective user ID. 

Tfie real user ID identifies the person who is logged in. The effective user ID gives the process 
additional permissions during execution of '^'set-user-ID" mode processes, which use getuid to 
determine the real-user-id of the process which invoked them. 

SEE ALSO 

getgid(2), setreuid(2) 
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NAME 

ioctl - control device 

SYNOPSIS 

#include <8y8/ioetLh> 

loctl(d, request, argp) 
Int d, request; 
char ""argp} 

DESCRIPTION 

Ioctl performs a variety of functions on open descriptors. In particular, many operating charac- 
teristics of character special files (e.g. terminals) may be controlled with to c</ requests. The write- 
ups of various devices in section 4 discuss how ioctl applies to them. 

An ioctl requett has encoded in it whether the argument is an "in" parameter or "out" parame- 
ter, and the size of the argument argp in bytes. Macros and defines used in specifying an ioctl 
request are located in the file <ey8/ioctl.h> . 

RETURN VALUE 

If an error has occurred, a value of -1 is returned and errno is set to indicate the error. 

If no error has occurred (using a STANDARD device driver), a value of b returned. 

ERRORS 

Ioctl will fail if one or more of the following are true: 

|EBADF| D is not a valid descriptor. 

[ENOTTY] D is not associated with a character special device. 

[ENOTTY] The specified request does not apply to the kind of object which the descriptor d 

references. 

jEINVAL] Request or argp is not valid. 

SEE ALSO 

execve(2), fcntl(2), mtio(4), tty(4) 
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NAME 

kill - send signal to a process 

SYNOPSIS 

km(pid, Big) 
Int pid, slgs 

DESCRIPTION 

Kill sends the signal aig to a process, specified by the process number pid. Sig may be one of the 
signals specified in 8igvec(2), or it may be 0, in which case error checking is performed but no sig- 
nal is actually sent. This can be used to check the validity of pid. 

The sending and receiving processes must have the same effective user ID, otherwise this call is 
restricted to the super-user. A single exception is the signal SIGCONT which may always be sent 
to any child or grandchild of the current process. 

If the process number is 0, the signal is sent to all other processes in the sender's process group; 
this b a variant of killpg{2). 

If the process number is -1, and the user is the super-user, the signal is broadcast universally 
except to system processes and the process sending the signal. 

Processes may send signals to themselves. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Kill will fail and no signal will be sent if any of the following occur: 

[EINVAL] Sig is not a valid signal number. 

[ESRCH] No process can be found corresponding to that specified by pid. 

(EPERM] The sending process is not the super-user and its effective user id does not match 

the effective user-id (^ the receiving process. 

SEE ALSO 

getpid(2), getpgrp(2), killpg(2), sigvec(2> 
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NAME 

killpg - send signal to a process group 

SYNOPSIS 

kiUpgCpgrp, Big) 
int pgrp, sig; 

DESCRIPTION 

Killpg sends the signal sig to the process group pgrp. See 8igvec{2) for a list of signals. 

The sending process and members of the process group must have the same effective user ID, oth- 
erwise this call is restricted to the super-user. As a single special case the continue signal 
3IGC0NT may be sent to any process which is a descendant of the current process. 

RETURI^ VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned and the 
global variable errno is set to indicate the error. 

ERRORS 

Killpg will fail and no signal will be sent if any of the following occur: 

[EINVAL] Sig is not a valid signal number. 

[ESRCH] No process were found in the specified process group. 

[EPERM] The sending process is not the super-user and one or more of the target processes 

has an effective user ID different from that of the sending process. 

SEE ALSO 

k}}l(2), getpgrp(2), 8igvec(2) 
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NAME 

link - make a hard link to a file 

SYNOPSIS 

link(namel, nameS) 
char *namel, *nam«2; 

DESCRIPTION 

A hard link to namel is created; the link has the name nameS. Namel must exist. 

With hard links, both namel and nameS must be in the same file system. Unless the caller is the 
super-user, namel must not be a directory. Both the old and the new link share equal access and 
rights to the underlying object. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Link will fail and no link will be created if one or more of the following are true: 

[EPERM] Either pathname contains a byte with the high-order bit set. 

[ENOENT] Either pathname was too long. 

[ENOTDIR] A component of either path prefix is not a directory. 

(ENOENT] A component of either path prefix does not exist. 

[EACCES] A component of either path prefix denies search permission. 

[ENOENT] The file named by name! does not exist. 

[EEXIST] The link named by name8 does exist. 

[EPERM] The file named by namel is a directory and the effective user ID is not super- 

user. 

[EXDEV] The link named by nameB and the file named by namel are on different file sys- 

tems. 

[EACCES] The requested link requires writing in a directory with a mode that denies write 

permission. 

The requested link requires writing in a directory on a read-only file system. 

One of the pathnames specified is outside the process's allocated address space. 

Too many symbolic links were encountered in translating the pathname. 



[EROFS] 

[EFAULT] 

[ELOOP] 

SEE ALSO 

8ymlink(2), ttnlink(2) 
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NAME 

listen - listen for connections on a socket 

SYNOPSIS 

li8ten(e, backlog) 
Int »f backlog; 

DESCRIPTION 

To accept connections, a socket is first created with 90cket{2), a backlog for incoming connections 
is specified with li8ten{2) and then the connections are accepted with accept{2). The listen call 
applies only to sockets of type SOCK_STREAM or SOCK_PKTSTREAM. 

The backlog parameter defines the maximum length the queue of pending connections may grow 
to. If a connection request arrives with the queue full the client will receive an error with an indi- 
cation of ECONNREFUSED. 

RETURN VALUE 

A return value indicates success; -1 indicates an error. 

ERRORS 

The call fails if: 

[EBADF] The argument 8 is not a valid descriptor. 

[ENOTSOCKl The argument 9 is not a socket. 

[EOPNOTSUPP| The socket is not of a type that supports the operation listen. 

SEE ALSO 

accept(2), connect(2), socket(2) 

BUGS 

The backlog is currently limited (silently) to 5. 
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NAME 

Iseek, tell - move read/write pointer 

SYNOPSIS 

#deflne L_SET /* set the seek pointer */ 

#deflne LJ[NCR 1 /* increment the seek pointer */ 

#deflne L.XTND 2 /* extend the file «ise */ 

pos sss lseek(dy offset, whence) 

int pos| 

int d, offset, whence) 

DESCRIPTION 

The descriptor d refers to a file or device open for reading and/or writing. Lseek sets the file 
pointer of (f as follows: 

If whence is L_SET, the pointer is set to offset bytes. 

If whence is L_INCR, the pointer is set to its current location plus offset. 

If whence is LJJCTND, the pointer is set to the size of the file plus offset. 

Upon successful completion, the resulting pointer location as measured in bytes from beginning of 
the file is returned. Some devices are incapable of seeking. The value of the pointer associated 
with such a device is undefined. 

The obsolete function teUffUdes) is identical to tseekfJUdes, OL, L_INCR). 

NOTES 

Seeking far beyond the end of a file, then writing, creates a g^ or "hole", which occupies no phy- 
sical space and reads as zeros. 

RETURN VALUE 

Upon successful completion, a non-negative integer, the current file pointer value, is returned. 
Otherwise, a value of -1 b returned and errno is set to indicate the error. 

ERRORS 

LseekwiSl fail and the file pointer will remain unchanged if: 

(EBADF] Fildes is not an open file descriptor. 

[ESFIFE] Fildes is associated with a pipe or a socket. 

[EINVAL] Whence is not a proper value. 

[EINVAL] The resulting file pointer would be negative. 

SEE ALSO 

dup(2), open(2) 
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NAME 

mkdir - make a directory file 

SYNOPSIS 

inkdir(path| mode) 
char *path; 
int mode; 

DESCRIPTION 

Mkdir creates a new directory file with name path. The mode of the new file is initialized from 
mode. (The protection part of the mode is modified by the process's mode mask; see uma8k{2)). 

The directory's owner ID is set to the process's effective user ID. The directory's group ID is set 
to that of the parent directory in which it is created. 

The low-order 9 bits of mode are modified by the process's file mode creation mask: all bits set in 
the process's file mode creation mask are cleared. See uma8k(2). 

RETURN VALUE 

A return value indicates success. A -1 return value indicates an error, and an error code is 
stored in errno. 

ERRORS 

Mkdir will fail and no directory will be created if: 

(EPERM] The process's effective user ID is not super-user. 

jEPERM] The path argument contains a byte with the high-order bit set. 

[ENOTDIR] A component of the path prefix is not a directory. 

{ENOENT] A component of the path prefix does not exist. 

[EROFS] The named file resides on a read-only file system. 

[EEXIST] The named file exists. 

[EFAULT] Path points outside the process's allocated address space. 

[ELOOP| Too many symbolic links were encountered in translating the pathname. 

(EIOJ An I/O error occured while writing to the file system. 

SEE ALSO 

chmod(2), stat(2), umask(2) 
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NAME 

mknod - make a special file 

SYNOPSIS 

snk]iQod(path, mode, dev) 

Int mode, dev; 

DESCRIPTION 

Mknod creates a new file whose name is path. The mode of the new file (including special file bits) 
is initialized from mode. (The protection part of the mode is modified by the process's mode 
mask; see uma8k{2)). The first block pointer of the i-node is initialized from dev and is used to 
specify which device the special file refers to. 

If mode indicates a block or character special file, dev is a configuration dependent specification of 
a character or block I/O device. If mode does not indicate a block special or character special 
device, dev is ignored. 

Mknod may be invoked only by the super-user. 

RETURN VALUE 

Upon successful completion a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

EEEOES 

Mknod will fail and the file mode will be unchanged if: 

[EPERMj The process's effective user ID is not super-user. 

fEPERM] The pathname contains a character with the high-order bit set. 

(ENOTDIR| A component of the path prefix is not a directory. 

{ENOENTj A component of the path prefix does not exist. 

fEROFS] The named file resides on a read-only file system. 

(EEXIST) The named file exists. 

[EFAULT] Path points outside the process's allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

SEE ALSO 

chmod(2), stat(2), umask(2) 
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NAME 

mmap - map pages of memory 

SYNOPSIS 

#include <8y8/ininan.h> 
#include <8ys/type8.h> 

minap(addry len, prot» share, fd, off) 
caddr_t addr; int len, prot, share, fd; offjt off; 

DESCRIPTION 

N.B.t This call Is not completely implemented in 4.2. 

Mmap maps the pages starting at addr and continuing for ten bytes from the object represented 
by the descriptor fd, at the current file position of offset off. The parameter share specifies 
whether modifications made to this mapped copy of the page are to be kept private or are to be 
shared with other references. The parameter prot specifies the accessibility of the mapped pages. 
The addr and len parameters and the sum of the current position in fd and the off parameters 
must be multiples of the page size (found using the getpage8ize{2) call). 

Pages are automatic^Iy unmapped at close. 

RETURN VALUE 

The call returns on success, -1 on failure. 

ERRORS 

The mmap call will fail if: 

(EINVAL] The argument address or length is not a multiple of the page size as returned by 
getpage8ize(2),or the length is negative. 

[EINVAL] The entire range of pages specified in the call is not part of data space. 

[EINVAL] The specified fd does not refer to a character special device which supports mapping 
(e.g. a frame buffer). 

[EINVAL] The specified fd is not open for reading and read access is requested, or not open for 
writing when write access b requested. 

[EINVAL] The sharing mode was not specified as MAP_SHARED. 

SEE ALSO 

getpagesize(2), munmap(2), close(2) 
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NAME 

mount, umount - mount or remove file system 

SYNOPSIS 

mount(8pecialy name, rwflag) 
char ^special, *naine; 
int rwfiagi 

uinount(speelal) 
char *8pecial| 

DESCRIPTION 

Mount announces to the system that a removable file system has been mounted on the block- 
structured special file special; from now on, references to file name will refer to the root file on the 
newly mounted file system. Special and name are pointers to null-terminated strings containing 
the appropriate path names. 

Name must exbt already. Name must be a directory. Its old contents are inaccessible while the 
file system is mounted. 

The rwflag argument determines whether the file system can be written on; if it is writing is 
allowed, if non-zero no writing is done. Physically write-protected and magnetic tape file systems 
must be mounted read-only or errors will occur when access times are updated, whether or not 
any explicit write is attempted. 

Umount announces to the system that the special file is no longer to contain a removable file sys- 
tem. The associated file reverts to its ordinary interpretation. 

RETURN VALUE 

Mount returns if the action occurred, -1 if special is inaccessible or not an appropriate file; if 
name does not exist; if specie^ is already mounted; if name is in use; or if there are already too 
many file systems mounted. 

Umount returns if the action occurred; -1 if if the special file is inaccessible or does not have a 
mounted file i^stem, or if there are active files in the mounted file system. 

ERRORS 

Mpunt will fail when one of the following occurs: 

[NODEVj The caller is not the super-user. 

[NODEV] Special does not exist. 

[ENOTBLK] Special is not a block device. 

[ENXIO] The major device number of special is out of range (this indicates no device 

driver exists for the associated hardware). 

[EPERM] The pathname contains a character with the high-order bit set. 

(ENOTDIR] A component of the path prefix in name is not a directory. 

[EROFS] Name resides on a read-only file system. 

[EIBUSY] Name is not a directory, or another process currently holds a reference to it. 

[EBUSY] No space remains in the mount table. 

[EBUSY] The super block for the file system had a bad magic number or an out of range 

block size. 

[EBUSY] Not enough memory was available to read the cylinder group information for the 

file system. 

[EBUSY] An i/o error occurred while reading the super block or cylinder group informa- 

tion. 
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Umount may fail with one of the following errors: 

[NODEVj The caller is not the super-user. 

(NODEVJ Sp ecial docs not exist. 

(ENOTBLKJ Special is not a block device. 

[ENXIO] The major device number of special is out of range (this indicates no device 

driver exists for the associated hardware). 

[EINVAL] The requested device is not in the mount table. 

[EBUSY] A process is holding a reference to a file located on the file system. 

SEE ALSO 

mount(8), umount(8) 

BUGS 

The error codes are in a state of disarray; too many errors tappezi to the caller as one value. 
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NAME 

munmap - unmap pages of memory 

SYNOPSIS 

#include <mman.h> 

munmap(addr, len) 
caddrjfe addr; int len; 

DESCRIPTION 

NJB.: Thb call Is not completely implemented In 4.2. 

Munmap causes the pages starting at addr and continuing for len bytes to refer to private pages 
which will be initialized to zero on reference. 

RETURN VALUE 

The call returns -1 on error, on success. 

ERRORS 

The call fails if any of the following: 

[EINVAL] The argument address or length is not a multiple of the page size as returned by 
f/etpage8ize{2),or the length is negative. 

[EINVAL] The entire range of pages specified in the call is not part of data space. 

SEE ALSO 

brk (2), mmap(2), close(2) 
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NAME 

open - open a file for reading or writing, or create a new file 

SYNOPSIS 

#liiclude <8ys/flle.h> 

open(path, flags, mode) 
char *path; 
int flags, mode; 

DESCRIPTION 

Open opens the file path for reading and/or writing, as specified by the flage argument and returns 
a descriptor for that file. The flags argument may indicate the file is to be created if it does not 
already exist (by specifying the 0_CREAT flag), in which case the file is created with mode mode 
as described in chmod{2) and modified by the process' umask value (see uma8k(2)). 

Path is the address of a string of ASCII characters representing a path name, terminated by a null 
character. The flags specified are formed by or'ing the following values 

OJRDONLY open for reading only 

0_WRONLY open for writing only 

O JIDWR open for reading and writing 

0_NDELAY do not block on open 

0_APPEND append on each write 

0_CREAT create file if it does not exist 

0_TRUNC truncate size to 

OJEXCL error if create and file exists 

Opening a file with 0_APPEND set causes each write on the file to be appended to the end. If 
0_TRUNC is specified and the file exists, the file is truncated to zero length. If 0_EXCL is set 
with 0_CREAT, then if the file already exists, the open returns an error. This can be used to 
implement a simple exclusive access locking mechanism. If the 0_NDELAY flag is specified and 
the open call would result in the process being blocked for some reason (e.g. waiting for carrier on 
a dialup line), the open returns immediately. The first time the process attempts to perform i/o 
on the open file it will block (not currently implemented). 

Upon successful completion a non-negative integer termed a file descriptor is returned. The file 
pointer used to mark the current position within the file is set to the beginning of the file. 

The new descriptor is set to remain open across ezecve system calls; see clo8e{2). 

There is a system enforced limit on the number of open file descriptors per process, whose value is 
returned by the getdtabie8ize{2) call. 

RETURN VALUE 

The value -1 is returned if an error occurs, and external variable errno is set to indicate the cause 
of the error. Otherwise a non-negative numbered file descriptor for the new open file b returned. 

ERRORS 

Open fails if: 

(EPERM] The pathname contains a character with the high-order bit set. 

[ENOTDIRj A component of the path prefix is not a directory. 

(ENOENTJ 0_CREAT is not set and the named file does not exist. 

[EACCES] A component of the path prefix denies search permission. 

[EACCES] The required permissions (for reading and/or writing) are denied for the named 

file. 

[EISDIR] The named file is a directory, and the arguments specify it is to be opened for 

writing. 
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[EROFSj The named file resides on a read-only file system, and the file is to be modified. 

(EMFILEj {OPEN_MAX} file descriptors are currently open. 

[ETXTBSY] The file is a pure procedure (shared text) file that is being executed and the open 
call requests write access. 

[EFAULT] Patk points outside the process's allocated address space. 

|ELOOP] Too many symbolic links were encountered in translating the pathname. 

[EEXIST] 0_EXCL was specified and the file exists. 

jENXIOj The 0_NDELAY flag is given, and the file is a communications device on which 

there is no carrier present. 

[EOPNOTSUPPj 

An attempt was made to open a socket (not currently implemented). 

SEE ALSO 

chmod(2), close(2), dup(2), lseek(2), read(2), write(2), umask(2) 
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NAME 

pipe - create an interprocess communication channel 

SYNOPSIS 

pipe(fllde8) 
intfilde8[2]| 

DESCRIPTION 

The pipe system call creates an I/O mechanism called a pipe. The file descriptors returned can be 
used in read and write operations. When the pipe is written using the descriptor )S/<fe9[l] up to 
4096 bytes of data are buffered before the writing process is suspended. A read using the descrip* 
tor fildea\0] will pick up the data. 

It is assumed that after the pipe has been set up, two (or more) cooperating processes (created by 
subsequent fork calls) will pass data through the pipe with read And write calls. 

The shell has a syntax to set up a linear array of processes connected by pipes. 

Read calls on an empty pipe (no buffered data) with only one end (all write file descriptors closed) 
returns an end-of-file. 

Pipes are really a special case of the 8oeketpair{2) cbSI and, in fact, are implemented as such in 
the^stem. 

A signal is generated if a write on a pipe with only one end is attempted. 

RETURN VALUE 

The function value zero is returned if the pipe was created ; -1 if an error occurred^ 

ERRORS 

The pipe call will fail if: 

(ENfFILE) Too many descriptors are active. 

[EFAULT] The JUdes buffer is in an invalid area of the process's address space. 

SEE ALSO 

sh(l), read(2), WTite(2), fork(2), socketpair(2) 

BUGS 

Should more than 4096 bytes be necessary in any pipe among a loop of processes, deadlock will 
occur. 
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NAME 

profil - execution time profile 

SYNOPSIS 

profll(bulf, bufsls, offset, scale) 

char *buff; 

Int buf sis, offset, scale; 

DESCRIPTION 

£u^ points to an area of core whose length (in bytes) is given by bufsiz. After this call, the user's 
program counter (pc) is examined each clock tick (20 milliseconds); offset is subtracted from it, 
and the result multiplied by scale. If the resulting number corresponds to a word inside buff, that 
word is incremented. 

The scale is interpreted as an unsigned, fixed-point fraction with binary point at the left: 0x10000 
gives a 1-1 mapping of pc's to words in buff; 0x8000 maps each pair of instruction words together. 
0x2 maps all instructions onto the beginning of iuj^ (producing a non-interrupting core clock). 

Profiling is turned off by giving a scale of or 1. It is rendered ineffective by giving a bttfsiz of 0. 
Profiling is turned off when an exeeve is executed, but remains on in child and parent both after a 
fork. Profiling is turned off if an update in iu^ would cause a memory fault. 

RETURN VALUE 

A 0^ indicating success, is always returned. 

SEE ALSO 

gprof(l),^ setitimer(2), monitor(3) 
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NAME 

ptrace - process trace 

SYNOPSIS 

#inelude <signal.h> 

ptrace(reque8t, pid, addr, data) 
int request, pid, ^addr, data; 

DESCRIPTION 

Ptrace provides a means by which a parent process may control the execution of a child process, 
and examine and change its core image. Its primary use is for the implementation of breakpoint 
debugging. There are four arguments whose interpretation depends on a request argument. Gen- 
erally, pid is the process ID of the traced process, which must be a child (no more distant descen- 
dant) of the tracing process. A process being traced behaves normally until it encounters some 
signal whether internally generated like "illegal instruction" or externally generated like "inter- 
rupt". See 9t^t;ec(2) for the list. Then the traced process enters a stopped state and its parent is 
notified via wait{2). When the child is in the stopped state, its core image can be examined and 
modified using ptrace. If desired, another ptrace request can then cause the child either to ter- 
minate or to continue, possibly ignoring the signal. 

The value of the request argument determines the precise action of the call: 

This request is the only one used by the child process; it declares that the process is to be 
traced by its parent. All the other arguments are ignored. Peculiar results will ensue if the 
parent does not expect to trace the child. 

1,2 The word in the child process's address space at addr is returned. If I and D space are 
separated (e.g. historically on a pdp-11), request 1 indicates I space, 2 D space. Addr must be 
even. The child must be stopped. The input data is ignored. 

3 The word of the ^stem's per-process data area corresponding to addr is returned. Addr must 
be even and less than 512. This space contains the registers and other information about the 
process; its layout corresponds to the user structure in the ^stem. 

4,5 The given data is written at the word in the process's address space corresponding to addr, 
which must be even. No useful value is returned. If I and D space are separated, request 4 
indicates I space, 5 D space. Attempts to write in pure procedure fail if another process is 
executing the same file. 

6 The process's system data b written, as it b read with request 3. Only a few locations can 
be written in this way: the general registers, the floating point status and registers, and cer- 
tain bits of the processor status word. 

7 The data argument is taken as a signal number and the child's execution continues at loca- 
tion addr as if it had incurred that signal. Normally the signal number will be either to 
indicate that the signal that caused the stop should be ignored, or that value fetched out of 
the process's image indicating which signal caused the stop. If addr is (int *)1 then execution 
continues from where it stopped. 

8 The traced process terminates. 

9 Execution continues as in request 7; however, as soon as possible after execution of at least 
one instruction, execution stops again. The signal number from the stop is SIGTRAP. (On 
the Sun and VAX-11 the T-bit is used and just one instruction is executed.) This is part of 
the mechanism for implementing breakpoints. 

As indicated, these calls (except for request 0) can be used only when the subject process has 
stopped. The wait call is used to determine when a process stops; in such a case the "termina- 
tion" status returned by wait has the value 0177 to indicate stoppage rather than genuine termi- 
nation. 
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To forestall possible fraud, ptraee inhibits the set-user-id and set-group-id facilities on subsequent 
execve{2) ealls. If a traced process calls execve, it will stop before executing the first instruction 
of the new image showing signal SIGTRAP. 

On the Sun and VAX-11, "word" also means a 32-bit integer, but the "even" restriction does not 
apply. 

RETURN VALUE 

A value is returned if^ the call succeeds. If the call fails then a -I is returned amd the global 
variable errna is set to indicate the error. 

ERRORS 

[EINVALj The request code is invalid. 

[EINVAL) The specified process does not ex&t. 

[EINVALJ The given signal number is invalid. 

[EPAlEiT] The specified address » oui of bounds. 

[EPER\^ The specified process cannot be traced. 

SEE ALSO 

wait(2K 8igvec(2), adb(tS) 

BUGS 

Ptraee is unique and arcane; it should be replaced with a special file which can be opened and 
read and written. The control functions could then be implemented with iocU{2) calls on this file. 
This would be simpler to understand and have much higher performance. 

The request call should be able to specify signals which are to be treated normally and not 
cause a stop. In this way, for example, programs with simulated floating point (which use "illegal 
instruction" signals at a very high rate) could be efficiently debugged. 

The error indication, -1, is a legitimate function value; errno, see intro{2), can be used to disam- 
biguate. 

It should be possible to stop a process on occurrence of a system call; in this way a completely 
controlled environment could be provided. 
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NAME 

quota -manipulate disk quotas 

SYNOPSIS 

#lnclude <Bya/quota.h> 

quota(eindy uid, arg, addr) 
Int cmd, uld, arg; 
caddrjt addr; 

DESCRIPTION 

The quota call manipulates disk quotas for file ^sterns which have had quotas enabled with get- 
quota{2). The cm (/ parameter indicates a command to be applied to the user ID uid. Arg is a 
command specific argument and addr is the address of an optional, command specific, data struc- 
ture which is copied in or out of the system. The interpretation of arg and addr is given with 
each command below. 

Q.SETDLIM 

Set disc quota limits and current usage for the user with ID uid. Arg is a major^minor 
device indicating a particular file system. Addr is a pointer to a struct dqblk structure 
(defined in <8y8/quota.h>). This csJl is restricted to the super-user. 

QJ3ETDLIM 

Get disc quota limits and current usage for the user with ID uid. The remaining parame- 
ters are as for QJSETDLIM. 

Q_SETDUSE 

Set disc usage limits for the user with ID uid. Arg b a major-minor device indicating a 
particular file system. Addr b a pointer to a struct dqusage structure (defined in 
<8y8/quota.h>). Thb call b restricted to the super-user. 

Q_SYNC 

Update the on-disc copy of quota usages. The uid, arg, and airfr parameters are ignored. 

Q_SETUID 

Change the calling process's quota limits to those of the user with ID uid. The arg and 
addr parameters are ignored. Thb call b restricted to the super-user. 

Q_SETWARN 

Alter the disc usage warning limits for the user with ID uid. Arg is a major-minor device 
indicating a particular file system. Addr is a pointer to a struct dqwarn structure (defined 
in <8y8/quota.h>). Thb call b restricted to the super-user. 

Q_DOWARN 

Warn the user with user ID uid about excessive disc usage. This call causes the system to 
check its current disc usage information and print a message on the terminal of the caller 
for each file system on which the user is over quota. If the arg parameter is specified as 
NODEV, all file systems which have disc quotas will be checked. Otherwise, arg indicates 
a specific major-minor device to be checked. Thb call is restricted to the super-user. 

RETURN VALUE 

A successful call returns and, possibly, more information specific to the cmi performed; when an 
error occurs, the value -1 b returned and errno b set to indicate the reason. 

ERRORS 

A quota call will fail when one of the following occurs: 

[EINVALl Cmd b invalid. 

[ESRCH] No dbc quota is found for the indicated user. 

[EPERM] The call is priviledged and the caller was not the super-user. 
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[EINVAL] The arg parameter is being interpreted as a major-minor device and it indicates 

an unmounted file system. 

[EPAULT] An invalid addr is supplied; the associated structure could not be copied in or 

out of the kernel. 

[EUSERSf The quota table is full. 

SEE ALSO 

setquota(2), quotaon(8^» quotacheck(8) 

BUGS 

There should be someway to integrate this call with the resource limit interface provided by 
9etrUmit{2)znd getrtimit{2). 

The Australian spelling of disk is used throughout the quota facilities in honor of the implemen- 
tors. 
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NAME 

read, readv - read input 

SYNOPSIS 

cc SB read(d, buf, nbytes) 
int ee» d| 
char *buf| 
Int nbytesi 

#lnclud« <Bys/types.h> 
#include <Bys/ulo.h> 

cc = readv(d, lov, lovent) 

Int cc, d; 

struct lovec *Iovi 

Int lovent; 

DESCRIPTION 

Read attempts to read nbyteg of data from the object referenced by the descriptor d into the 
buffer pointed to by buf. Readv perfornu the same action, but scatters the input data into the 
iovcnt buffers specified by the members of the iovec airay: iov|0], iov[l], ..., iov(iovcnt-l]. 

For readv, the iovec structure is defined as 

struct iovec { 

caddr_t iov_base; 

int iov_len; ' 

}; 

Each iovec entry specifies the base address and length of an area in memory where data should be 
placed. Readv will always fill an area completely before proceeding to the next. 

On objects capable of seeking, the read starts at a position given by the pointer associated with d, 
see l8eek{2). Upon return from read, the pointer is incremented by the number of bytes actually 
read. 

Objects that a^e not capable of seeking always read from the current position. The value of the 
pointer associated with such a object is undefined. 

Upon successful completion, read and readv return the number of bytes actually read and plaM:ed 
in the buffer. The system guarantees to read the number of bytes requested if the descriptor 
references a file which has that many bytes left before the end-of-file, but in no other cases. 

If the returned value is 0, then end-of-file has been reached. 

RETURN VALUE 

If successful, the number of bytes actually read is returned. Othewise, a -1 is returned and the 
global variable errno is set to indicate the error. 

ERRORS 

Read and readvwill fail if one or more of the following are true: 

[EBADF] Fildes is not a valid file descriptor open for reading. 

[EFAULT] Buf points outside the allocated address space. 

[EINTR] A read from a slow device was interrupted before any data arrived by the 

delivery of a signal. 

In addition, readv may return one of the following errors: 

[EINVAL] Iovcnt was less than or equal to 0, or greater than 16. 

[EINVAL] One of the to v_/en values in the tot; array was negative. 

[EINVAL] The sum of the toi;_/en values in the tot; array overflowed a 32-bit integer. 
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SEB ALSO 

dup(2), opeii(2), pipe(2), 80cket(2), socketpair(2) 
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NAME 

readlink - read value of a qrmbolic link 

SYNOPSIS 

cc =B readUnk(path, buf, bufsU) 

int CC) 

char *path» *buf} 

int buffix; 

DESCRIPTION 

Readlink places the contents of the symbolic link name in the buffer buf which has size hufsiz. 
The contents of the link are not null terminated when returned. 

RETURN VALUE 

The call returns the count of characters placed in the buffer if it succeeds, or a -1 if an error 
occurs, placing the error code in the global variable errno. 

ERRORS 

Readlink will fail and the file mode will be unchanged if: 

[EPERN^ The path argument contained a byte with the high-order bit set. 

lENOENT] The pathname was too long. 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

(ENXIO] The named file is not a symbolic link. 

jEACCES] Search permission is denied on a component of the path prefix. 

jEPERM] The effective user ID does not match the owner of the file and the effective user 

ID is not the super-user. 

[EINVAL] The named file is not a symbolic link. 

[EFAULT] Buf extends outside the process's allocated address space. 

[E^LOOP] Too many symbolic links were encountered in translating the pathname. 

SEE ALSO 

8tat(2), lstat(2), symlink(2) 
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NAME 

reboot - reboot system or halt processor 

SYNOPSIS 

#Include <ays/rebooi.h> 

reboot(howto) 
Int howtoi 

DESCRIPTION 

Reboot reboots the system, and is invoked automatically in the event of unrecoverable system 
failures. Howto is a mask of options passed to the bootstrap program. The system call interface 
permits only RBJHALT or RB__AUTOBOOT to be passed to the reboot program; the other flags 
are used in scripts stored on the console storage media, or used in manual bootstrap procedures. 
When none of these options (e.g. RB_AUTOBOOT) is given, the system is rebooted from file 
"vmunix" in the root file qrstem of unit of a disk chosen in a processor specific way. An 
automatic consistency check of the disks is then normally performed. 

The bits of hoxuio are: 

RBJLVLT 

the processor is simply hadted; no reboot takes place.. RBJFIALT should be used with 
caution. 

RB^ASKNAME 

Interpreted by the bootstrap program itself, causing it to in<iutre as to what file should be 
booted. Normally, the system is booted from the file "vmunix" without asking. 

RB_SINGLE 

Normally, the reboot procedure involves an automatic disk consistency check and then 
multi-user operations. RB_SINGLE prevents the consistency check, rather simply boot- 
ing the system with a single-user shell on the console. RBJSINGLE is interpreted by the 
tntf(8) program in the newly booted system. This switch is not available from the ^stem 
call interface. 

Onty the super-user may reboot a machine. 

RETURN VALUES 

If successful, this call never returns. Otherwise, a -1 is returned and an error is returned in the 
global variable errno. 

ERRORS 

[EPERM] The caller is not the super-user. 

SEE ALSO 

cra8h(8S), halt(8), init(8), reboot(8) 
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NAMiJ 

recv, recvfrom, recvmsij - reGcive a message from a socket 

SYNOPSIS 

#include <sy0/typeB.h> 
#lnclude <sys/80cket.h> 

cc === recv(S| buf, len, flags) 
int ec, 8| 
ehar *buf} 
int lePt flagil 

cc = recvfrom(i, buf, len, flagi, f^oniy firomlen) 

Int cc, s{ 

char *buf{ 

Int len, flags; 

struct sockaddr *firoms 

Int *fk>omlenj 

cc = recvm8g(s, msg, flags) 
int cc, 8} 

struct msghdr msgQ; 
int flagsf 

DESCRIPTION 

Recv, recvfrom, znd recvrrug are used to receive messages from a socket. 

The recv call may be used only on a conneciti socket (see emnect{2)^f wMle recvfrom and 
recvmsg may be used to receive data on a socket whether it is in a connected state or not. 

II from is non^zero, the source address of the message b filled in. Fromkn is a value-result 
parameter, initiaiized to the size of the buffer associated with from, and modified on return to 
indicate the actual size of the address stored there. The length of the message is returned in cc. 
If a message is too long to fit in the supplied buffer, excess bytes may be discarded depending on 
the type of socket the message is received from; see 8oeket{2). 

If no messages are available at the socket, the receive call waits for a message to arrive, unless the 
socket is nonblocking (see ioctt{2)} in which case a cc of -1 is returned with the external variable 
errno set to EWOULDBLOCK. 

The 8elect{2) call may be used to determine when more data arrives. 

The flags argument to a send call is formed by or'ing one or more of the values, 

#define MSG„PEEK 0x1 /* peek at incoming message */ 
#define MSG„OOB 0x2 /* process out-of-band data */ 

The recvmag c?M uses a msghdr structure to minimize the number of directly supplied parameters. 
This structure has the foHowing form, as defined in Keys/ socket. h>: 

struct msghdr { 

caddrjt msgjaame; /* optional address ♦/ 

int msg_namelen; /* size of address */ 

struct iovec *msgJov; /♦ scatter /gather array */ 

int msg^iovlen; /* # elements in msg^iov */ 

caddr_t m8g_accrights; /* access rights sent/received */ 
int msg^accrightslen; 

}; 

Here msg_name and m8g__namelen specify the destination address if the socket is unconnected; 
m8g_njame may be given as a null pointer if no names are desired or required. The msgjiov and 
msgjiovlen describe the scatter gather locations, as described in read{2). Access rights to be sent 
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along with the message are specified in m8g_accright8, which has length m8g_accright8len. 

RETURN VALUE 

These calb return the number of bytes received, or -1 if an error occurred. 

ERRORS 

The calb fail if: 

[EBADF] The argument 9 is mi invalid descriptor. 

[ENOTSOCK| The argument svsnots socket. 

(EWQULDBLOCK] The socket is marked non-blocking and the receive operation would block. 

(EINTR] The receive was interrupted by delivery of a signal before any data^ was 

available for the receive. 

(EPAULT] The data was specified to be received mto a non-existent or protected part 

of the process address space.. 

SEE ALSO 

read(2), send(2), 8ocket(2y 
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NAME 

rename - change the name of a file 

SYNOPSIS 

rename(firoinf to) 
char ""firoin, *to| 

DESCRIPTION 

Rename causes the link named from to be renamed as to. If to exists, then it is first removed. 
Both from and to must be of the same type (that is, both directories or both non-directories), and 
must reside on the same file system. 

Rename guarantees that an instance of to will always exist, even if the system should crash in the 
middle of the operation. 

CAVEAT 

The system can deadlock if a loop in the file system graph is present. This loop takes the form of 
an entry in directory "a", say "a/foo", being a hard link to directory "b", and an entry in direc- 
tory "b", say "b/bar", being a hard link to directory "a". When such a loop exists and two 
separate processes attempt to perform "rename a/foo b/bar" and "rename b/bar a/foo", respec- 
tively, the system may deadlock attempting to lock both directories for modification. Hard links 
to directories should be replaced by symbolic links by the system administrator. 

RETURN VALUE 

A value is returned if the operation succeeds, otherwise rename returns -1 and the global vari- 
able errno indicates tbe reason for the failure. 

ERRORS 

Rename will fail and neither of the argument files will be affected if any of the following are true: 

[ENOTDIR] A component of either path prefix is not a directory. 

[ENOENT] A component of either path prefix does not exist. 

[EACCES] A component of either path prefix denies search permission. 

[ENOENT] The file named by from does not exist. 

[EPERM) The file named by from is a directory and the effective user ID is not super-user. 

[EXDEV] The link named by to and the file named by from are on different logical devices 

(file systems). Note that this error code will not be returned if the implementa- 
tion permits cross-device links. 

[EACCES] The requested link requires writing in a directory with a mode that denies write 

permission. 

The requested link requires writing in a directory on a read-only file system. 

Path points outside the process's allocated address space. 

From is a parent directory of to. 



[EROFS] 

[EFAULT] 

[EINVAL] 

SEE ALSO 

open (2) 
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NAME 

rmdir - remove a directory file 

SYNOPSIS 

rmdlr(path) 
char ""path; 

DESCRIPTION 

Rmdir removes a directory file whose name is given by path. The directory must not have any 
entries other than "." and "..". 

RETURN VALUE 

A is returned if the remove succeeds; otherwise a -1 is returned and an error code is stored in 
the global location errno . 

ERRORS 

The named file is removed unless one or more of the following are true: 

lENOTEMPTY) The named directory contains files other than "." «id ".." in it. 

[EP£RK<Q The pathname contains a^ character with the high-wder bit set. 

[ENOENT) The pathname was too long. 

[ENOTDIR] A component of the patK^ prefix is not a directory. 

[ENOENT[ The named file does not exist. 

[EACCESj A component of the path prefix denies search permission. 

[EACCES] Write permission is denied on the directory c<mtaining the link to be removed. 

jEBUSY] The directory to be removed is the mount point for a mounted file system. 

[ESIOFS] The directory entiy to be removed resides on a read-K>nly file system. 

(EFAULT) Path p<Hnts outside the process's allocated address space. 

[ElrOOPj Too many symbolic Ifnks were encountered in tranriating the pathname.. 

SEE ALSO 

mkdrr(2)/ unlink(2) 
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NAME 

select - synchronous I/O multiplexing 

SYNOPSIS 

#include <ByB/tlme.h> 

nfds = select(width, readfds, writefds, exeeptfdst timeout) 
int width, "'readfds, *writefdB, *execptfd8| 
struct timeval *timeout| 

DESCRIPTION 

Select examines the I/O descriptors specified by the bit masks rea^fda, writefda, and execptfds to 
see if they are ready for reading, writing, or have an exceptional condition pending, respectively. 
Width is the number of significant bits in each bit mask that represent a file descriptor. Typically 
width has the value returned by getdtablesize (2) for the maximum number of file descriptors or is 
the constant 32 (number of bits in an int). File descriptor /is represented by the bit "l<<f" in 
the mask. Select returns, in place, a mask of those descriptors which are ready. The total 
number of ready descriptors is returned in nfds. 

If timeout is a non-zero pointer, it specifies a maximum interval to wait for the selection to com- 
plete. If timeout is a zero pointer, the select blocks indefinitely. To effect a poll, the timeout 
argument should be non-zero, pointing to a zero valued timeval structure. 

Any of readfdt, writefds, and execptfds may be given as if no descriptors are of interest. 

RETURN VALUE 

Select returns the number of descriptors which are contained in the bit masks, or -I if an error 
occurred. If the time limit expires then select returns 0. 

ERRORS 

An error return txom select indicates: 

[EBADF] One of the bit masks specified an invalid descriptor. 

[EINTR] An signal was delivered before any of the selected events occurred or the time 

limit expired. 

SEE ALSO 

accept(2), connect(2), gettimeofday(2), read(2), write(2), recv(2), send(2), getdtablesize(2) 

BUGS 

The descriptor masks are always modified on return, even if the call returns as the result of the 
timeout. 
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NAME 

send, sendto, sendmsg - send a message from a socket 

SYNOPSIS 

#include <8y8/type8.h> 
#inciude <^^s/tocket.h> 

ee SB send(sy vamg, len, flags) 
int cc, 8} 
char *in8g; 
|;it len, flags; 

#B ss Bendto(B, msg, len, flags, to, tolen) 

|»t cc, s; 

||iar *msg; 

^t leat flags;. 

etruet soekaddr *to; 

i|^t tolenf 

ce Bs 8endm8g(s, msg,^ fl^g*) 

Int ec, sf 

struct m8ghdr msgQr 

Intflagsc 

DESCRIPTION 

5 is ft socket created wHh 8ocket{2). Send, senito, and sendrmg are used to transmit a message to 
another socket. Stnd majr be used onl^ wKen the socket is in a^ cotmtcted state, while aendio and 
stndmsg may be used at any time. 

The address of the target is given by to with tolen specifying its size. The length of the message 
is given by Itn. If the message is too Tong to pass atomicaily through the underlying protocol, 
then the error EMSGSIZE is returned, and the message is not traisiamitted^ 

No indication of failure to deliver is implicit in a atnd. Return values of -1 indicate some locally 
detected errors. 

If no messages space is available at the socket to hold the message to be transmitted, then 8tnd 
normally blocks, unless the socket has been placed in noa-blocking i/o mode. The 8dect{2) call 
may be used to determine when it is possible to send more data. 

The ftag8 parameter ia«T he set to SOP_OOB to send "out-of-band" data on sockets which sup- 
port this notion (e.g. SOCK^STREAM). 

See ticv{2\ lof & description of the rmghdr structure. 

RETURN VALUE 

The call returns the nomber of characters sent, or -1 if an error occirred^ 

ERRORS 

[EBADF) An invalid de8crQ>tor^wa8 specified. 

^NOTSOCKI The argument « i» not a sock^t^ 

(EPAULT} An invalid user space address was speeded for a parameter. 

l^fSGSIZE) The socket requfres that message be sent atomicaily, and the size of the 

message to be sent made this impossible. 

[EWOULDBLOCK] The socket is marked hob-blocking and the requested operation would 
block. 

SEE ALSO 

recv(2), 66cket(^) 
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NAME 

setgroups - set group access list 

SYNOPSIS 

#iiiclude <By8/parain.h> 

setgroup8(ngroupe» gidset) 
int ngroupa, ^gidset) 

DESCRIPTION 

Setgroups sets the group access list of the current user process according to the array gidget. The 
parameter ngroupe indicates the number of entries in the array and must be no more than 
NGRPS, as defined in <8y8/param.h>. 

Only the super-user may set new groups. 

RETURN VALUE 

A value is returned on success, -1 on error, with a error code stored in errno. 

ERRORS 

The setgroups call wiH fail if: 

(EPERM] The caller is not the super-user. 

(EFAULT] The address specified for gidset is outside the process address space. 

SEE ALSO 

getgroups(2), initgroups(3) 
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NAME 

setpgrp - set process group 

SYNOPSIS 

Betpgrp(pld, pgrp) 
int pid, pgrp) 

DESCRIPTION 

Setpgrp sets the process group of the specified process pid to the specified pgrp. If pid is zero, then 
the call applies to the current process. 

If the invoker is not the super-user, then the affected process must have the same effective user-id 
as the invoker or be a descendant of the invoking process. 

RETURN VALUE 

Setpgrp returns when the operation was. successful. If the request ^led,^ -1 is returned and the 
global variable errno indicates the reason. 

ERRORS 

Setpgrp will fail and the process group win not be altered if one of the following occur: 

[ESRCH] The requested process does not exist. 

(EPERM) The effective user ID of the requested process is different from that of the caller 

and the process is not a^descendent of the calling process. 

^^BALSO 

getpgrp(2) 
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NAME 

setquota - enable/disable quotas on a file system 

SYNOPSIS 

setquota(8pecial, file) 
char ""special, *flle; 

DESCRIPTION 

Disc quotas are enabled or disabled with the setquota call. Special indicates a block special device 
on which a mounted file system exists. If file is nonzero, it specifies a file in that file i^stem from 
which to take the quotas. If file is 0, then quotas are disabled on the file system. The quota file 
must exist; it is normally created with the quotacheek(8) program. 

Only the super-user may turn quotas on or off. 

SEE ALSO 

quota(2), quotacheck(8), quotaon(8) 

RETURN VALUE 

A return value indicates a successful call. A value of -1 is returned when an error occurs and 
errno is set to indicate the reason for failure. 

ERRORS 

Setquota will fail when one of the following occurs: 

|NODEVj The caller is not the super-user. 

(NODEVl Special does not exist. 

lENGTBLK) Special is not a block device. 

[ENXIO] The major device number of special Ib out of range (this indicates no device 

driver exists for the associated hardware). 

{EPERMJ The pathname contains a character with the high-order bit set. 

jENOTDIR] A component of the path prefix in file is not a directory. 

[EROFS] File resides on a read-only file system. 

[EACCES] File resides on a file system different from special. 

[EACCES] File is not a plain file. 



BUGS 



The error codes are in a istate of disarray; too many errors appear to the caller as one value. 
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NAME 

setregid - set real and effective group ID 

SYNOPSIS 

setregid(rgld, egid) 
int rgid, egid; 

DESCRIPTION 

The real and effective group ID's of the current process are set to the arguments. Only the 
super-user may change the real group ID of a process. Unpriviledged- users may change the 
effective group ID to the real group ID, but to no other. 

Supplying a value of -1 for either the real or effective group ID forces the system to substitute the 
current ID in place of the -1 parameter. 

RETURN VALUE 

Upon strccessful completion, a value of is returned.^ Otherwise, a value of ~t is returned and 
ermo is set to indicate the error. 

ERRORS 

[EPERM^ The current process is not the sttper<»user and a change other than changmg the 

effective group-id to the real group-id was specified. 

SEE ALSO 

getgid(2)7 setreuid(2), 8etgtd(3C) 
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NAME 

setreuid - set real i^ad effective user ID's 

SYNOPSIS 

«etreuld(ruid, euld) 
int ruld» euld; 

DESCRIPTION 

The real and effective user ID's of the current process are set according to the arguments. If ruid 
or euidis -1, the current uid is filled in by the system. Only the super-user may modify the real 
uid of a process. Users other than the super-user may change the effective uid of a process only to 
the real uid. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

[EPERM] The current process is not the super-user and a change other than changing the 

effective user-id to the real user-id was specified. 

SEE ALSO 

getuid(2), 8etregid(2), setuid(3) 
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NAME 

shutdown - shut down part of a full-duplex connectioa 

SYNOPSIS 

8hutdown(8f how) 
int s» how; 

DESCRIPTION 

The shutdown call causes all or part of a full-duplex connection on the socket associated with s to 
be shut down. If how is 0, then further receives will be dballowed. If how is 1, then further sends 
will be disallowed. U ho wis 2, then further sends and receives will be disallowed^ 

DIAGNOSTICS 

A is returned if the call succeeds, -1 if it fails. 

ERRORS 

The call succeeds unless: 

[EBADF] 5^18 not a valid descriptor. 

[ENOTSOCK) 5 is a file, not a socket. 

[ENOTCONN) The specified socket b not connected. 

SEE ALSO 

eonnect(2), 80cket(2)^ 

BUGS 

The /How values shonld be defined constants. 
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NAME 

sigblock - block signals 

SYNOPSIS 

oldmask ss 8igbloek(ma8k)| 
int mask; 

DESCRIPTION 

Sigblock zddB the signals specified in mask to the set of signak currently being blocked from 
delivery. Signal i is blocked if the t'-l'th bit in ma$kw a 1. The previous mask is returned, and 
may be restored using 8ig8etma8k{2). 

It is not possible to block SIGKILL, SIGSTOP, or SIGCONT; this restriction is silently imposed 
by the system, 

RETURN VALUE 

The previous set of masked signals is returned. 

SEE ALSO 

kill(2), sigvec(2), 8igsetma8k(2), 



86 



Last change: 4 January 1984 Sun Release 1.1 



SIGPAUSE(2) SYSTEM CALLS SIGPAUSE(2) 



NAME 

sigpause - atomically release blocked signak and wait for interrupt 

SYNOPSIS 

8lgpauBe(BigmaBk) 
Int sigmanki 

DESCRIPTION 

Sigpaute assigns tigmaek to the set of ntasked signak and then waits for a signal ta arrive; on 
return the set of masked signals is restored. Sigmask is usually to indicate that no signals are 
now ta be blocked. Sigpauee always terminates by being interrupted^ returning EINTR. 

In normal usage, a signal u blocked using 8igblock{2), to begin a critical section, variables 
modified on the occurance of the signal are examined to determine that there is no work to be 
done^and the |»'oce8& pauses awaiting work by using eigpause with the mask returned by aigblock. 

SEE ALSO 

8igbloek(2), srgvec(2) 
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NAME 

sigsetmask - set current signal mask 

SYNOPSIS 

8ig8etina8k(ma8k)) 
int maak; 

DESCRIPTION 

Sigsetmask sets the current signal mask (those signals which are blocked from delivery). Signal t 
is blocked if the t-l'th bit in mask is a 1. 

The system quietly disallows SIGKILL, SIGSTOP, or SIGCONT to be blocked. 

RETURN VALUE 

The previous set of masked signals is returned. 

SEE ALSO 

kill(2), sigvec(2), sigbIock(2), 8igpause(2) 
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NAME 

sigstack - set and/or get signal stack context 

SYNOPSIS 

#inelude <8lgnal.h> 

struct slgstmek { 

caddrjt isjip} 

int M_oiiitaek| 

}i 

■lgatack(8f, oat) 

struct aigstack *8ay ""oBai 

DESCRIPTION 

Sigetack allows users to define an alternate stack on which signak are to be processed. If ss is 
noD-zero, it specifies a signat stack on which to deliver signals and tells the system if the process is 
currently executing on that stack. When a signal's action indicates its handler should execute on 
the signal stack (specified with a 8igvec{2) call)^ the ^stem cfiecks to see if the process fs 
currenUy executmg on that stack. If the process is not currently executing on the signal stack, 
the system arranges a switch to the signial stack for the duration of the signal handler's execution. 
If 099 is non-zero, the current signal stack state is returned. 

NOTES ^ li 

Signal stacks sore not "grown" automatically, ia is done for tite nwrnal stack. If the stack 
overflowi unpredictable results may occur. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise,^ a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

Sig9tack will fail and the signal stack context will remain unciiaitged if one of the following 
occurs. 

I^AULT] Either 99 or 099 points to memory which is not a valid part of the process 

address space. 

SEE ALSO 

8igvec(2), 8etjmp(3) 
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NAME 

sigvec - software signal facilities 

SYNOPSIS 

#includ« <8ignal.h> 

struct ilgvec { 

int (*sv_handler)()) 

Int tv.inaski 

int tv.onitacki 

}l 

slgvec(tlg, vce, ovee) 
int dgi 
struct sigvec *v«e, *ovec| 

DESCRIPTION 

The system defines a set of signals that may be delivered to a process. Signal delivery resembles 
the occurence of a hardware interrupt: the signal is blocked from further occurrence, the current 
process context is saved, and a new one is built. A process may specify a handler to which a sig- 
nal is delivered, or specify that a signal is to be blocked or iffnored. A process may also specify 
that a default action is to be taken by the system when a signal occurs. Normally, signal 
handlers execute on the current stack of the process. This may be changed, on a per-handler 
basis, so that signals are taken on a special signal etaek. 

All signals have the same priority. Signal routines execute with the signal that caused their invo> 
cation blocked, but other signals may yet occur. A global signal mask defines the set of signals 
currently blocked from delivery to a process. The signal mask for a process is initilized from that 
of its parent (normally 0). It may be changed with a 8igblock{2) or 8ig$etma8k{2) call, or when a 
signal is delivered to the process. 

When a siglsal condition arises for a process, the signal is added to a set of signals pending for the 
process. If the signal is not currently blocked by the process then it is delivered to the process. 
When a signal is delivered, the current state of the process is saved, a new signal mask is calcu- 
lated (as described below), and the signal handler is invoked. The call to the handler is arranged 
so that if the signal handling routine returns normally the process will resume execution in the 
context from before the signal's delivery. If the process wishes to resume in a different context, 
then it must arralige to restore the previous context itself. 

When a signal is deliveriid to a process a new signal mask is installed for the duration of the pro- 
cess' signal handler (or until a sigbloek or sigtetmask call b made). This mask is formed by taking 
the current signal mask, adding the signal to be delivered, and or'ing in the signal mask associ- 
ated with the handler to be invoked. 

Sigvec assigns a natidler for a specific signal. If vee is non-zero, it specifies a handler routine and 
mask to be used when delivering the specified signal. Further, if 9v_on8tack is 1, the lystem will 
deliver the signal to the process on a signal stack, specified with 8igstaek{2). If ovec is non-zero, 
the previous handling information for the signal is returned to the user. 

The following is a list of all signals with names as in the include file <8ignal.k>: 



SIGHUP 


1 


hangup 




SIGINT 


2 


interrupt 




SIGQUIT 


3* 


quit 




SIGILL 


4* 


illegal instruction 




SIGTRAP 


5* 


trace tra^) 




SIGIOT 


6* 


lOT instruction 




SIGEMT 


7* 


EMT instruction 




SIGFPE 


8* 


floating point exception 




SIGKILL 


9 


kill (cannot be caught, blocked. 


or ignored) 
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SIGBUS 


10* 


SIGSEGV 


11* 


SIGSYS 


12* 


SIGPIPE 


13 


SIGALRM 


14 


SIGTERM 


15 


SIGURG 


16 


SIGSTOP 


17t 


SIGTSTP 


18t 


I^IGCONT 
PIGCHLD 
PIGTTIN 
filGTTOU 


10* 
20* 
21t 
22t 


SIGIO 


23 


SIGXCPU 


24 


SrGXFSZ 


25 


SIGVTALRM 26 


SIGPROF 


27 


SIGWINCH 


28 
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bus error 

segmentation violation 
bad argument to system call 
write on a pipe with no one to read it 
alarm clock 

software termination signal 
urgent condition present on socket 
stop (cannot be caught, blocked, or ignored) 
stop signal generated from keyboard 
10* continue after stop (cannot be blocked) 
child status has changed 

background read attempted from control terminal 
background write attempted to control terminal 
i/o is possible on a descriptor (see /cn//(2)) 
cpu time limit exceeded (see 8etrKmii{2)) 
file size limit exceeded (see eetrlimit{2)) 
virtual time alarm (see 8etiHmer(2)) 
profiling timer alarm (see 9eHtimer{2}) 
window changed (see u;»n(4S)) 

The starred signals in the list above cause a core image if not caught or ignored. 

Once a signal handler is installed, it remains installed until another sigvec call is made, or an 
exeeve{2) is performed. The default action for a signal may be reinstated by setting 9v_handler to 
SIGJDFL; this default is termination (with a core image for starred signals) except for signals 
marked with • or f* Signals marked with • are discarded if the action is SIGJDFL; signals 
marked with f cause the process to stop. If svjhahdler is SIG_IGN the signal is subsequently 
ignored, and pending instances of the signal are discarded. 

If a caught signal occurs during certain system calls, causing the call to terminate prematurely, 
the call is automatically restarted. In particular this can occur during a read or write{2) on a slow 
device (such aji a terminal; but not a file) and during a wait{2). 

After a fork{2) or vfork{2) the child inherits all signals, the signal mask, and the signal stack. 

The execve{2) call resets all caught signals to default action; ignored signals remain ignored; the 
signal mask remains the same; the signal stack state is reset. 

I^OTES 

The mask specified in vee is not allowed to block SIGKILL, SIGSTOP, or SIGCONT. This is 
done silently by the system. 

RETURN VALUte 

A value indicated that the call succeeded. A -1 return value indicates an error occured and 
errno it set to indicated the reason. 

ERRORS 

Sigvee will fail and no new signal handler will be installed if one of the following occurs: 

[EFAULT] Either vec or ovee points to memory which is not a valid part of the process 

address space. 

[EKNVAL] Sig is not a valid signal number. 

lEiNYAL) An attempt is made to ignore or supply a handler for SIGKILL or SIGSTOP. 

(EINVAL) An attempt is made to ignore SIGCONT (by default SIGCONT is ignored). 

SEE ALSO 

kill(l), ptrace(i), kill(2), sigblock(2), sigsetmask(2), sigpause(2) sigstack(2), sigvec(2), setjmp(3), 
tty(4) 
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NOTES (VAX-11) 

The handler routine can be declared: 

handler(sig, code, scp) 

int sig, code; 

struct sigcontext *scp; 

Here sig is the signal number, into which the hardware faults and traps are mapped as defined 
below. Code is a parameter which is either a constant as given below or, for compatibility mode 
faults, the code provided by the hardware (Compatibility mode faults are distinguished from the 
other SIGILL traps by having PSL_CM set in the psl). Scp is a pointer to the eigcontext struc- 
ture (defined in < 8ignal.h>), used to restore the context from before the signal. 

The following defines the mapping of hardware traps to signals and codes. All of these symbols 
are defined in <8ignaLh>: 



BUGS 



Hardware condition Signal 

Arithmetic traps: 

Integer overflow SIGFPE 

Integer division by zero SIGFPE 

Floating overflow trap SIGFPE 
Floating/decimal division by zero SIGFPE 

Floating underflow trap SIGFPE 

Decimal overflow trap SIGFPE 

Subscript-range SIGFPE 

Floating overflow fault SIGFPE 

Floating divide by zero fault SIGFPE 

Floating underflow fault SIGFPE 

Length access control SIGSEGV 

Protection violation SIGBUS 

Reserved instruction SIGILL 

Customer-reserved instr. SIGEMT 

Reserved operand SIGILL 

Reserved addressing SIGILL 

Trace pending SIGTRAP 

Bpt instruction SIGTRAP 

Compatibility-mode SIGILL 

Chme SIGSEGV 

Chms SIGSEGV 

Chmu SIGSEGV 

This manual page is confusing. 



Code 



FPE_INTOVF_TRAP 

FPEJNTDIV_TRAP 

FPEJ'LTOVF^TRAP 

FPEJFLTDIVJTRAP 

FPE_FLTUND_TRAP 

FPE_DECOVFjrRAP 

FPE_SUBRNG_TR AP 

FPE_FLTOVF_FAULT 

FPE_FLTDIV_FAULT 

FPE FLTUNDJ'AULT 



ILLJIESAD_FAULT 

ILL_PRIVIN_FAULT 
ILL_PESOP_FAULT 



hardware supplied code 
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NAME 

socket - create an endpoint for communication 

SYNOPSIS 

#include <8y8/type8.h> 
#inelude <sy«/Bocket.h> 

8 ss 80cket(af, type, protocol) 
Int Bf at, type, protocol) 

DESCRIPTION 

Socket creates an endpoint for communication and returns a descriptor. 

The af parameter specifies an address format with which addresses specified in later operations 
using the socket should be interpreted. These formats are defined in the include file 
<8y8j&iickttJi> . The currently understood formats are 

AF JUNDC (UNIX path name8>, 

AFJNET (ARPA Internet addresses^, 

AF_PUP pCerox PUP-I Internet addresses), and 

AFJMPUNK (IMP "host at IMP" addresses). 

The socket has the indicated typt which specifies the semantics of communication. Currently 
defined types arer 

SOCK_STREAM 
SOCK.DGRAM 
SOCK RAW 
SOCK-SEQPACKET 
SOCK_RDM 

A SOCK^STREAM type provides sequenced, reliable, two-way connection based byte streams 
with an out-of-band data transmission mechanism. A SOCK_DGRAM socket supports datagrams 
(connectionless, unreliable messages of a fixed (typically small) maximum length). SOCK_RAW 
sockets provide access to internal network interfaces. The types SOCK.RAW, which is available 
only to the^uper-user, and SOCK_SEQPACI<ET and SOCK_RDM, which are planned, but not 
yet implemented, are not described here. 

The protocol Specifies a particular protocol to be used with the socket. Normally only a single 
protocol exist! to support a particular socket type using a given address format. However, it is 
possible that many protocols may exist in whicb case a particular protocol must be specified in 
this manner. The protocol number to use is particular to the "communication domain" in which 
communication is to take place; see «ert;tce«(3N) and protocol8{Zli). 

Sockets of type SOCK.STREAM are full-duplex byte streams, similar to pipes. A stream socket 
must be in a connected state before any data may be sent or received on it. A connection to 
another socket is created with a connect(2) call. Once connected, data may be transferred using 
rtai{2) and write{2) calb or some variant of the eend{2) and recv{2) calls. When a session has 
been completed a cloae{2) may be performed. Out'Of-band data may also be transmitted as 
described in eeni^) and received as described in recv(2). 

The communica^tibns protocols used to implement a SOCK_STREAM insure that data is not lost 
or duplicated. If k piece of data for which the peer protocol has buffer space cannot be success- 
fully transmitted withtol a reasonable length of time, then the connection is considered broken and 
calls will indicate an error with -1 returns and with ETIMEDOUT as the specific code in the glo- 
bal variable errno. The protocols optionally keep sockets "warm" by forcing transmissions 
roughly every minute in the absence of other activity. An error is then indicated if no response 
can be elicited on an otherwise idle connection for a extended period (e.g. 5 minutes). A SIG- 
PIPE signal is raised if a process sends on a broken stream; this causes naive processes, which do 
not handle the signal, to exit. 
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SOCK_DGRAM and SOCK_RAW sockets allow sending of datagrams to correspondents named 
in 8end{2) calls. It is also possible to receive datagrams at such a socket with rect;(2). 

An fcnU{2) call can be used to specify a process group to receive a SIGURG signal when the out- 
of-band data arrives. 

The operation of sockets is controlled by socket level options. These options are deflned in the 
file <8ii8/80cket.k> and explained below. Setaockopt and get8oekopt{2) are used to set and get 
options, respectively. 

SO_DEBUG turn on recording of debugging information 

SO_REUSEADDR allow local address reuse 

SO_KEEP ALIVE keep connections alive 

SO_pONTROUTE do no app^ routing on outgoing messages 

SO_LINGER linger on close if data present 

SoIdONTLINGER do not linger on close 

SO.DEBUG enables debugging in the underlying protocol modules. SOJREUSEADDR indicates 
the rules used in validating addresses supplied in a bind{2) call should allow reuse of local 
addresses. SO_K£EP ALIVE enables the periodic transmission of messages on a connected socket. 
Should the connected party fail to respond to these messages, the connection is considered broken 
and processes using the socket are notified via a SIGPIPE signal. SO_DONTROUTE indicates 
that outgoing messages should bypass the standard routing facilities. Instead, messages are 
directed to the appropriate network interface according to the network portion of the destination 
address. SOJLINGER and SOJDONTLINGER control the actions taken when unsent messags 
are queued on socket and a clo8e{2) is performed. If the socket promises reliable delivery of data 
and SOJL>INGER is set, the system will block the process on the close attempt until it is able to 
transmit the data or until it decides it is unable to deliver the information (a timeout period, 
termed the linger interval, is specified in the setsockopt call when SO_LINGER is requested). If 
SO_PONTLINGER is specified and a close is issued, the system will process the close in a 
manner which allows the process to continue aa quickly as possible. 

RETURN VALUE 

A -1 is returned if an error occurs, otherwise the return vai^e is a descriptor referencing the 
socket. 

ERRORS 

The socket call fails if: 

[EAFNOSUPPORT] The specified address family is not supported in this version of the system. 

[ESOCKTNOSUPPORT] 

The specified socket type is not supported in this address family. 

IeprotonosupportJ 

The specified protocol is not supported. 

|EMFILE] The per-process descriptor table is full. 

[ENOBUFS] No buffer space is available. The socket cannot be created. 

SEE ALSO 

accept(2), bind(2), conneci(2), getsockname(2), getsockopt(2), ioct1(2), listent2), recv(2), select(2), 

send(2), shutdown(2), socketpair(2) 

"A 4.2BSD Interprocess Communication Primer". 



BUGS 



The use of keepalives is a questionable feature for this layer. 
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NAME 

socketpair - create a pair of connected sockets 

SYNOPSIS 

#include <8y8/typet.h> 
#include <ByB/Bocket.h> 

soeketpAlr(d, type, protocol, by) 
ll^t d, type, protocol; 
Int uv[2]} 

DESCRIPTION 

The ftfcketpair system call creates an unnamed pair of connected sockets in the specified domain 
d, of the specified type and using the optionally specified protoeot. The descriptors used in 
referencing the new sockets are returned in 8v[0\ and 8v\l\. The two sockets are indisttngufshabre. 

DL^GNOSTICS 

A is returned if the call succeeds, -1 ST it faHs. 

ERRORS 

The call succeeds unlessi- 

[E^IFILE] Too many descriptors are in use by this process. 

[EAFNOSUPPORT] The specified address family is not supportedhon this machine. 

[EPROTONOSUPPORTI 

The specified protocol is not supported on this machine. 

[EOPNOSUPPORT] The specified protocol does not support creation of socket pairs. 

[EFAULT] The address 8v does not specify a valid part of the process address space. 

SEE ALSO 

resd(2), write(2), pipe(2) 

BUGS 

This call is currently implemented only for the UNIX domain. 
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NAME 

Stat, ktat, fstat ~ get file status 

SYNOPSIS 

#include <By8/type8.h> 
#iiiclude <8ys/stat.h> 

stat(pathy buf) 
char *path; 
struct stat *buf; . 

lstat(path, buf), 
char *path} 
struct stat "'buf) 

f8tat(fd, buf) 

intfdi 

struct stat *buf} 

DESCRIPTION 

Stat obtains information about the file path. Read, write or execute permission of the named file 
is not required, but all directories listed in the path name leading to the file must be reachable. 

Lstat is like stat except in the case where the named file is a symbolic link, in which case btat 
returns information about the link, while stat returns information about the file the link refer- 
ences. 

Fstat obtains the same information about an open file referenced t>y the argument descriptor, such 
as would be obtained by an open call. 

Bt^is a pointer to a stat structure into which information is placed concerning the file. The con- 
tents of the structure pointed to by buf 



struct stat { 



st mtime 



/* device inode resides on */ 

/* this inode's number */ 

/* protection */ 

/* number or hard links to the file */ 

/* user-id of owner */ 

/* group-id of owner */ 

/* the device type, for inode that is device */ 

/♦ total size of file ■*/ 

/* file last access time */ 

/* file last modify time */ 

/* file last status change time */ 

/* optimal blocksize for file system i/o ops */ 
/* actual number of blocks allocated */ 



read or modified. Changed by the following system 
calls: mknod{2), utimes{2), read{2), write{2), and truncate{2). For reasons of 
efficiency, st__atime is not set when a directory is searched, although this would be 
more logical. 

Time when data was last modified. It is not set by changes of owner, group, link 
count, or mode. Changed by the following system calls: mknod{2), utime8{2), 



devj 


st_dev; 


ino_t 


stjno; 


ujshort 


stjnode; 


short 


st_nlink; 


short 


st_uid; 


short 


st_gid; 


dev_t 


8t_rdev; 


ofl.t 


stjBizej 


time_t 


st_atime; 


int 


st_sparel; 


time_t 


st.mtime; 


int 


st_spare2; 


time_t 


st_ctime; 


int 


st_spare3; 


long 


st_blksize; 


lon^ 


st_blocks; 


lonjg 


st_8pare4l2|; 


>; 




St atime Time when 


file data was 
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#define S_IFMT 


0170000 


#define S.IFDIR 


0040000 


#<lefinc S_IFCHR 


0020000 


#define S.IFBLK 


0060000 


#definc S^IFREG 


0100000 


#define S.IFLNK 


0120000 


#define S„IFSOCK 


0140000 


#dcfine S JSUID 


0004000 


#define SJSGm 


0002000 


#dcflne S JSVTX 


0001000 


#define S.IREAD 


0000400 


#define S JWRITE 


0000200 


#deflne S_IEXEC 


0000100 



write(2). 

stjctime Time when file status was last changed. It is set both both by writing and changing 
the i-node. Changed by the following system calls: chmod{2) chown{2), link{2), 
mknod{2), unUnk{2), utime8{2), write{2), truncate{2). 

The status information word etjmode has bits: 

/* type of file */ 

/* directory */ 

/* character special */ 

/* block special */ 

/* regular */ 

/* symbolic link */ 

/* socket */ 

/* set user id on execution */ 

/* set group id on execution */ 

/* save swapped text even after use */ 

/* read permission, owner */ 

/* write permission, owner */ 

/* execute/search permission, owner */ 

The mode bits 0000070 and 0000007 encode group and others permissions (see chmod[2)). 

When fd u associated with a pipe, fstat reports an ordinary file with an i-node number, restricted 
permissions, and a not necessarily meaningful length. 

RETURN VALUE 

Upon successful completion a value of is returned. Otherwise, a value of -1 is returned and 
trrno is set to indicate the error. 

ERRORS 

Stai and Mat will fail if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

(EPERM) The pathname contains a character with the high-order bit set. 

(ENOENT) The pathname was too long. 

[ENOENT] The named file does not exist. 

|EACCES| Search permission is denied for a component of the path prefix. 

[EFAULT] Bt^or name points to an invalid address. 

Fitat will fail if one or both of the following are true: 

|EBADF| Fildei^la not a valid open file descriptor. 

|EFAULT| Btnf points to an invalid address. 

(E2L00P) Too many symbolic links were encountered in translating the pathname. 

CAVEAT 

The fields in the stat structure currently marked etjtpartl, st__8pare2, and st^spareS are present 
in preparation for inode time stamps expanding to 64 bits. This, however, can break certain pro- 
grams which depend on the time stamps being contiguous (in calls to utime8{2)). 

SEE ALSO 

chmod(2), cnown(2), utimes(2) 

BUGS 



Applying fstat to a socket returns a zero'd buffer. 
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NAME 

swapon - add a swap device for interleaved paging/swapping 

SYNOPSIS 

8wapon(«peclal) 
char *ipeclal| 

DESCRIPTION 

Swapon makes the block device «pecta/ available to the system for allocation for paging and swap- 
ping. The names of potentially available devices are known to the system and defined at ^stem 
configuration time. The size of the swap area on tpeeitU is calculated at the time the device is 
first made available for swapping. 

SEE ALSO 

8^apon(8), config(8) 

BUGS 

There is no way to stop swapping on a disk so that the pack may be dismounted. 

This call will be upgraded in future versions of the system. 
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NAME 

symiink - make symbolic link to a file 

SYNOPSIS 

8ymHiik(namel» oameS) 
char ""namely *naiQe2{ 

DESCRIPTION 

A symbolic link nameS is created to namel {nameS is the name of the file created, namel is the 
string used in creating the symbolic link). Either name may be an arbitrary path name; the files 
need not be on the same file system. 

RETURN VALUE 

Upon soccessfttl completion, a zero value is returned. If an error occurs, the error code is stored 
in ermo and a-1 value is returned. 

ERRORS 

The symbolie link is made unless on or more of the following are true: 

[EPERK^ Either namel or name2 contains a character with the high-order bit set, 

fENOENT] One of the pathnames specified was too \<mg^ 

[ENOIDIR) A component of^the nameS prefix irnot a directory. 

[EEXISTj NamtB already exists. 

jElACCESf A component of the nameS path prefix denies search permission. 

jEROFS] The file natneS would reside on a read-only file system. 

[EFAULT] Namel or nameS points outside the process's allocated address space. 

(ELOOFj Too may symbolic links were encountered in translating the pathname. 

SEE ALSO 

Iinkf2), ln(l), unirnk(2) 
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NAME 

sync - update super-block 

SYNOPSIS 

syncQ 

DESCRIPTION 

Sync causes all infcrmatioD in core memory that should be on disk to be written out. This 
includes modified super blocks, modified i-nodes, and delayed block I/O. 

Sync should be used by programs which examine a file system, for example Jack, df, etc. Sync is 
iijandatory before a boot. 

SEEALSP 

f8ync(2), 8ync(8), cron(8) 

BUGS 

The writing, although scheduled, is not necessarily complete upon return from eyne. 
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NAME 

sysealt- indirect system call ^ 

SYNOPSIS = 

ByBeaU(iiumber, arg, ...) 

DESCRIPTION 

SyaeaUpertonns ihe system call whose assembly language interface has the specified number, and 
arguments atg .... 

The register dO value of the i^stem call is returned. 

DIAGNdSTIGS 

^hen the Obit is set, eyacati returns -1 and sets the external variable ert^o (see intro{Z))^ 

BUGS 

llhere is^no way to simulate system calls such as pipt{2), which return values in register dl. 
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NAME 

truncate, ftruncate - truncate a file to a specified length 

SYNOPSIS 

truncate(path, length) 
char *path| 
int length) 

ftruncate(fd, length) 
int fd, length; 

DESCRIPTION 

Truncate causes the file named by path or referenced by fd to be truncated to at most length bytes 
in size. If the file previously was larger than this size, the extra data is lost. With /truncate, the 
file must be open for writing. 

RETURN VALUES 

A value of b returned if the call succeeds. If the call fails a -1 is returned, and the global vari- 
able errno specifies the error. 

ERRORS 

Truncate succeeds unless: 

[EPERM] The pathname contains a character with the high-order bit set. 

[ENOENT] The pathname was too long. 

jENOTDIR] A component of the path prefix of path is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] A component of the path prefix denies search permission. 

[EISDIR] The named file is a directory. 

jEEOFS] The named file resides on a read-only file system. 

[ETXTBSY] The file is a pure procedure (shared text) file that is being executed. 

[EFAULT] Name points outside the process's allocated address space. 

Ftruncate succeeds unless: 

[EBADF] The fd is not a valid descriptor. 

[EINVAL] The fd references a socket, not a file. 

SEE ALSO 

open (2) 

BUGS 

Partial blocks discarded as the result of truncation are not zero filled; this can result in holes in 
files which do not read as zero. 

These calls should be generalized to allow ranges of bytes in a file to be discarded. 
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NAME 

umask - set file creation mode mask 

SYNOPSIS 

oumask ss umaak(iiuinaBk) 
Int oum»8k» numaik; 

DESCRIPTION 

Umaffk sets the process*!!: file mode creation mask to numask and returns the previous valoe oi the 
mask^ The low-order 9^ bits of numa^k are used whenever a file is created, clearing corre^onding. 
k|t8 in the file mode (see ckmad{2)). This clearing allows each user to restrict the defauU access 
tg hiSb files. 

The vaTue is initially 022^ (write access for owner only). The made is ihhented by child processes. 

RETURN VALUB^ 

T|fe previous value of the file mode mask u returned by the call. 

SEE ALSp 

c|imod(2), raknod(2);^ open(2) 
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NAME 

unlink - remove directory entry 

SYNOPSIS 

unlink(path) 
chmr "'pmth) 

DESCRIPTION 

Unlink removes the entry for the file pathtiom its directory. If this entry was the last link to the 
file, and no process has the file open, then all resources associated with the file are reclaimed. If, 
however, the file was open in any process, the actual resource reclamation is delayed until it is 
closed, even though the directory entry has disappeared. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

ERRORS 

The unlink succeeds unless: 

[EPERMl The path contains a character with the high-order bit set. 

[ENOENT] The path name is too long. 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[EACCES] Write permission is denied on the directory containing the link to be removed. 

[EPERMj The named file is a directory and the effective user ID of the process is not the 

isuper-user. 

[EBUSY] The entry to be unlinked is the mount point for a mounted file system. 

[EROFS] The named file resides on a read-only file system. 

(EFAULT) Path points outside the process's allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

SEEALSO 

close(2), link(2), rmdir(2) 
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NAME 

utimes - set file times 

SYNOPSIS 

#lnelud« <ByB/types.h> 

utlines(flle, tvp) 

char *flle| 

struct timeval *tvp[2]; 

DESCRIPTION 

The utimea call uses the "accessed" and "updated" times in that order from the tvp vector to set 
the corresponding recorded times for file. 

The caller must be the owner of the file or the super-user. The "inode-changed" time of the file is 
set to the current time. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -I is returned and 
errno is set to indicate the error. 

ERRORS 

UHme will fail if one or mott of the following are true: 



|EPERM| 

[ENOENTI 

(ENOENT) 

[ENOTDIRl 

(EACCES) 

[EPERMI 

[EACCES] 

(ERCMFSl 

(EFAULTj 

pLOOPi 

SEE ALSO 

■tat(2> 



The pathname contained a character with the high-order bit set. 

The pathnamcr was too long. 

The named file does not exist. 

A component of the path prefix is not a directory. 

A component of thr patii prefix denies search permissm. 

The process is not super-user and not the owner of the file. 

The effective user ID is not super-user and not the owner of the file and timef is 
NULL and write access is denied. 

The file qrstem containing the file is mounted read-only;^ 

Tvp points outside the process's allocated address space. 

Too many symbolic links were encountered in translating the pathname. 
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NAME 

vadvise - give advice to paging system 

SYNOPSIS 

#lnelude <8ys/vadvlse.h> 

vadvise(parain) 
int parami 

DESCRIPTION 

Vadviee is used to inform the system that process paging behavior merits special consideration. 
Parameters to vadviee are defined in the file <vadvUie.h>. Currently, two calls t vadvise are 
implemented. 

The call 

vadvi8e(VAJ^NOM)j 

advises that the paging behavior is not likely to be well handled by the system's default algo- 
rithm, since reference information is collected over macroscopic intervals (e.g. 10-20 seconds) will 
not serve to indicate future page references. The system in this case will choose to replace pages 
with little emphasis placed on recent usage, and more emphasis on referenceless circular behavior. 
It is eseential that processes which have very random paging behavior (such as LISP during gar- 
bage collection of very large address spaces) call vadvite, as otherwise the system has great 
difficulty dealing with their page-consumptive demands. 

The call 

vadvlie(VA„NORM)| 
restores default paging replacement behavior after a call to 

vadvlie(VA_ANOM)) 



BUGS 



Will go away soon, being replaced by a per-page madviie facility. 
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NAME 

vfork - spawn new process in a virtual memory efficient way 

SYNOPSIS 

pld » vforkO 
Int pld| 

DESCRIPTION 

Vfork can be used to create new processes without fully copying the address space of the old pro- 
cess, which is horrendously inefficient in a paged environment. It is useful when the purpose of 
fork{2) would have been to create a new system context for an execve. Vfork differs from fork in 
that the child borrows the parent's memory and thread of control until a call to ezecve{2) or an 
exit (either by a call to exit{2) or abnormally.) The parent process is suspended while the child is 
using its resources. 

Vfork returns in the child's context and (later) the pid of the child in the parent's context. 

Vfork can normally be used just like fork. It does not work, however, to return while running in 
the childs context from the procedure which called vfork since the eventual return from vfork 
would then return to a no longer existent stack frame. Be careful, also, to call _€xit rather than 
exit if you can't execve, since exit will flush and close standard I/O channels, and thereby mess up 
the parent processes standard I/O data structures. (Even with fork it is wrong to call exit since 
buffered data would then be flushed twice.) 

SEE ALSO 

fork(2), execve(2), sigvee(2), wait(2), 

DIAGNOSTICS 

Same as for fork. 

BUGS 

This system call will be eliminated when proper system sharfng mechanisms are implemented^ 
Users should not depend on the memory sharing semantics of vfork as it will, in that case, be 
made synonymous to fork. 

To avoid a possible deadlock situation, processes which are children in the middle of a vfork are 
never sent SIGTTOU or SIGTTIN signab; rather, output or iactls are allowed and input attempts 
result in an end-of-file indication. 
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NAME 

vhangup - virtually "hangup" the current control terminal 

SYNOPSIS 

vhangupQ 

DESCRIPTION 

Vhangup is used by the initialization process init{S) (among others) to arrange that users are given 
"clean"' terminals at login, by revoking access of the previous users' processes to the terminal. 
To effect this, vhangup searches the system tables for references to the control terminal of the 
invoking process, revoking access permissions on each instance of the terminal which it finds. 
Further attempts to access the terminal by the affected processes will yield i/o errors (EBADF). 
Finally, a hangup signal (SIGHUP) is sent to the process group of the control terminal. 

SEE ALl^O 

init (8) 

BUGS 

Access to the control terminal via /dev/tty is still possible. 

This call should be replaced by an automatic mechanism which takes place on process exit. 
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NAME 

wait, wait3 - wait for process to terminate or stop 

SYNOPSIS 

#include <8ys/walt.h> 

pid csB wait(8tatuB) 

Int pldi 

union wait *8tatu8s 

ptd as wait(O) 
int pId) 

#inelude <8y8/time.h> 
#lnelude <8y8/re80uree.h> 

pId asB walt3(8tatu8f option8| ru8age) 

Int p!d| 

union watt *8tatu8t 

Int optlonsi 

struct ruBag« *ru8age| 

DESCRIPTION 

Wait causes its caller to delay until a signal is received or one of its child processes terminates or 
stops due to tracing. If any child has died or stopped due to tracing and this has not been 
reported via wait, return is immediate, returning the process id and exit status of one of those 
children. If that child had died, it is discarded. If there are no children, return is immediate with 
the value -1 returned. If there are only running or stopped but reported children, the calling 
processes is suspended. 

On return from a successful wait call, status is nonzero, and the high byte of status contains the 
low byte of the argument to exit supplied by the child process; the low byte of status contains the 
terminatioQ status of the process. A more precise definition of the status word is given in 
<8y8/wait.h>. 

Waits Is an alternate mterface which allows both non«blocking status collection and the status of 
children stopped by any means. The status parameter is defined as above. The options parame- 
ter is used to indicate the call should not block if there are no processes which have status to 
report (WNOHANQ), and/or that children of the current process which are stopped due to a 
SIQTTIN, SIGTTOU. SIQTSTP, or SIGSTOP signal are eligible to have their status reported as 
well (WUNTRACE^). A terminated child is discarded after it reports status, and a stopped pro- 
cess will not report its status more than once. If rusage is non-zero, a summary of the resources 
used by the terminated process and all its children is returned. (This information is currently not 
available for stopped processes.) 

When the WNOHANQ option is specified and no processes have status to report, waits returns a 
pid of 0. The WNOHANG and WUNTRACED options may be combined by or'ing the two 
values. 

NOT^ 

See sigvec{2) for a list of termination statuses (signals); status indicates normal termination. A 
special status (0177) is returned for a stopped process which has not terminated and can be res- 
tarted; see ptrace{2) and sigvec{2). If the 0200 bit of the termination status is set, a core image of 
the process was produced by the system. 

If the parent process terminates witnout waiting on its children, the initialization process (process 
ID ss 1) inherits the children. 

Wait and waits are automatically restarted when a process receives a signal while awaiting termi- 
nation of a child process. 
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RETURN VALUE 

If wait returns due to a stopped due to tracing or terminated child process, the process ID of the 
child is returned to the calling process. Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

Waits returns -1 if there are no children not previously waited for; is returned if WNOHANG 
is specified and there are no stopped or exited children. 

ERRORS 

Wait will fail and return immediately if one or more of the following are true: 

(^CHILD] The calling process has no existing unwaited-for child processes. 

|:p)FAULT] The etatut or rusage arguments point to an illegal address. 

SEE ALSO 

exit(2) 
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NAME 

write, writev - write on a file 

SYNOPSIS 

wrlte(d, hut, nbytet) 
int d; 
char ""buf} 
Int nbyteti 

#lnclude <By8/type8.h> 
#lnclude <iy8/uio.h> 

wrltev(df iov, loveclen) 

Intdi 

■truct lovee *lov| 

Int loveeleni 

DESCRIPTION 

Write attempts to write nbytea of data to the object referenced by the descriptor d from the buffer 
pointed to by buf. Writev performs the same action, but gathers the output data from the iovlen 
buffers specified by the members of the iov array: iov[0], iov[l], etc. 

On objects capable of seeking, the write starts at a position given by the pointer associated with 
d, see l9eek{2). Upon return from write, the pointer is incremented by the number of bytes actu- 
ally written. 

Objects that are not capable of seeking always write from the current position. The value of the 
pointer associated with such an object is undefined. 

If the real user b not the super-user, then write clears the set-user-id bit on a file. This prevents 
penetration of system security by a user who "captures" a writable set-user-id file owned by the 
super-user. 

RETURN VALUE 

Upon successful completion the number of bytes actually writen is returned. Otherwise a -1 is 
returned and errno is set to indicate the error. 

ERRORS 

Write will fail and the file pointer will remain unchanged if one or more of the following are true: 

|EBADF) D is not a valid descriptor open for writing. 

[EPIPE] An attempt is made to write to a pipe that is not open for reading by any pro- 

cess. 

[EPIPE] An attempt is made to write to a socket of type SOCK.STREAM which is not 

connected to a peer socket. 

(EFBIG) An attempt waa made to write a file that exceeds the process's file size limit or 

the !!qiaximum me size. 

(EPAULT] Part oi\ iov or data to be written to the file points outside the process's allocated 

address space. 

SEE ALSO 

lseek(2), open(2), pif)e(2) 
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NAME 

intro - introduction to library functions 

DESCRIPTION 

Section 3 describes functions found in libraries. 

Thb section describes subroutines found in the system libraries. 

The main C library is /lib/libc.a, and contains all the system call entry points described in sec- 
tion 2 as well as functions described in several subsections here. The primary functions in the C 
library are described in the main section 3. Functions associated with the "standard I/O library" 
used by many C programs are found in section 3S. The libc library also includes the Internet net- 
work functions described in section 3N and routines providing compatibility with other UNIX sys- 
tems as described in section 3C as well as all the system entry points from section 2. 

Other sections here are: 

(3F) The 3F functions are all functions callable from FORTRAN. These functions perform 
the same jobs as the straight "3" functions do for C programmers. There are in fact 
three FORTRAN libraries, namely -11177 which contains the system interface routines, 
-1177 which is the I/O interface library, and -1F77 which is everything not contained in 
the other two. These libraries are searched automatically by the loader when loading 
FORTRAN programs. 

(3M) These functions constitute the math library. C declarations for the types of functions 
may be obtained from the include file <math.h>. To use these functions with C pro- 
grams use a -Im option with cc(l). They are automatically loaded as needed by the For- 
tran and Pascal compilers f77(l) and pc(l). 

(3X) Various specialized libraries have not been given distinctive captions. Files in which such 
libraries are found are named on appropriate pages if they don't appear in the libc library. 



FILES 

/lib/libc.a 

/u8r/lib/libc_p.a 

/usr/lib/libm.a 

/usr/lib/libm_p.a 

/usr/lib/libU77.a 

/usr/lib/libI77.a 

/usr/lib/libF77.a 

/usr/lib/libcurses. a 

/usr/lib/libdbm.a 

/usr/lib/libmp.a 

/usr/lib/libtermcap.a 

/usr/lib/libtermcapj>.a 

/usr/lib/libtermlib 

/usr/lib/libtermlibj>.a 

/usr/lib/libplot.a 

/usr/lib/lib300.a 

/usr/lib/lib3C0s.a 

/usr/lib/lib4014.a 

/usr/lib/lib450.a 

SEE ALSO 

intro(3C), intro(3S), intro(3F), intro(3M), intro(3N), nm(l), ld(l), cc(l), f77(l), intro(2) 

DIAGNOSTICS 

Functions in the math library (section 3M) may return conventional values when the function is 
undefined for the given arguments or when the value is not representable. In these cases the 
external variable errno (see intro{2)) is set to the value EDOM (domain error) or ERANGE (range 



C Library ((2), (3), (3N) and (30) routines) 
Profiling C library (for gprof{i)) 
Math Library -Im (see section 3M) 
Profiling version of -Im 
FORTRAN system interface (see section 3F) 
FORTRAN I/O (see section 3F) 
FORTRAN everything else (see section 3F) 
screen management routines (see cur8e8{3X) 
data base management routines (see dbm{ZX)) 
multiple precision math library (see mp(3X)) 
terminal handling routines (see termcap{ZX)) 



plot routines (see plot{ZX)) 
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error). The values of EDOM and ERANGE are defined in the include file <errno.h>. 



LIST OF FUNCTIONS 






Name 


Appears on Page 


Description 


abort 


abort. 3 


generate a fault 


abs 


abs.3 


integer absolute value 


alarm 


alarm .3c 


schedule signal after specified time 


alloca 


malloc.3 


memory allocator 


alphasort 


scandir.3 


scan a directory 


asctime 


ctime.3 


convert date and time to ASCII 


assert 


assert.3 


program verification 


atof 


atof.3 


convert ASCII to numbers 


atoi 


atof.3 


convert ASCII to numbers 


atol 


atof.3 


convert ASCII to numbers 


bcmp 


b8tring.3 


bit and byte string operations 


bcopy 


bstring.3 


bit and byte string operations 


bzero 


b8tring.3 


bit and byte string operations 


calloc 


malloc.3 


memory allocator 


cfree 


malloc.3 


memory allocator 


clearerr 


ferror.38 


stream status inquiries 


closedir 


directory ,3 


directory operations 


closelog 


syslog.3 


control ^stem log 


crypt 


crypt.3 


DES encryption 


ctime 


ctime.3 


convert date and time to ASCII 


dysize 


ctime.3 


convert date and time to ASCII 


ecvt 


ecvt.3 


output conversion 


edata 


end.3 


last locations in program 


encrypt 


crypt.3 


DES encryption 


end 


end.3 


last locations in program 


endfsent 


getfsent.3 


get file system descriptor file entry 


endgrent 


getgrent.3 


get group file entry 


endhostent 


getho8tent.3n 


get network host entry 


endnetent 


getnetent.3n 


get network entry 


endprotoent 


getprotoent.3n 


get protocol entry 


endpwent 


getpwent.3 


get password file entry 


endservent 


getservent.3n 


get service entry 


environ 


execl.3 


execute a file 


errno 


perror.3 


system error messages 


etext 


end.3 


last locations in program 


execl 


execl.3 


execute a file 


execle 


execl.3 


execute a file 


execlp 


execl.3 


execute a file 


execv 


execl.3 


execute a file 


execvp 


execl.3 


execute a file 


exit 


exit.3 


terminate a process after fiushing any pending output 


fclose 


fcl08e.38 


close or fiush a stream 


fcvt 


ecvt.3 


output conversion 


fdopen 


fopenSs 


open a stream 


feof 


ferror.38 


stream status inquvies 


ferror 


ferror.38 


stream status inquiries 


fflush 


fclo8e.38 


close or flush a stream 


ffs 


bstring.3 


bit and byte string operations 


fgetc 


getc.3s 


get character or integer from stream 


fgets 


gets.3s 


get a string from a stream 
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fileno 


ferror.Ss 


stream status inquirfes 


fopen 


f open .38 


open a stream 


fprintf 


printf.3s 


formatted output eonversion 


fputc 


putcSs 


put character or word on a stream 


fputo 


pufs.3s 


put a string on a stream 


fread 


fread.3s 


buffered binary input/output 


free 


mattoc.3 


memory alTocator 


freopen 


fopen.38^ 


open a^streamr 


frexp 


fEexp.3 


split mto mantttsa and exp(»ieiit^ 


fscanf 


8canf.3s^ 


formatted input c(Htversion 


fseek 


fieek.38^ 


reposition a stream 


ftelt 


f8eek.3s 


repo»tion a stream 


ftthte 


tfme.3c 


get da^fr and: tii^ 


fwrite 


fre3d.3a 


buffered: bmary input/output 


gcvt 


ecvt.3 


output conversion 


getc 


getc.3s 


get character or integer from stream 


getchar 


getc,3s 


get character or integer from stream 


getcBv 


getenv.3 


value for environment name 


getfsent 


getfsent.3 


get file system descriptor file entry 


getfsfile 


getfsent.3 


get file system descriptor file entry 


getfsspec 


getfsent.S 


get file system descriptor file entry 


getfstype 


getfsent.3 


get file system descriptor file entry 


getgrent 


getgrent.3 


get group file entry 


getgrgid 


getgrent.3 


get group file entry 


getgmam 


getgrent.3 


get group file entry 


gethostbyaddr 


gethostent.Sn 


get network host entry 


gethostbyname 


gethostent. 3n 


get network host entry 


gethostent 


getho8tent.3n 


get network host entry 


getlogiD 


getlogin.3 


get login name 


getnetbyaddr 


getnetent.3n 


get network entry 


getnetbyname 


getnetent.3n 


get network entry 


getnetent 


getnetent.3n 


get network entry 


getopt 


getopt.3c 


get option letter from argv 


getpass 


getpa8s.3 


read a password 


getprotobyname 


getprotoent.3n 


get protocol entry 


getprotobynumber 


getprotoent.3n get protocol entry 


getprotoeot 


getprotoent.3n 


get protocol entry 


getpw 


getpw.3 


get name from uid 


getpwent 


getpwent.3 


get password file entry 


getpwnam 


getpwent.3 


get password file entry 


getpwuici 


getpwent.3 


get password file entry 


gets 


get8.38 


get a string from a stream 


getservbyname 


getservent.Sn 


get service entry 


getservbyport 


getservent.3n 


get service entry 


getservent 


get8ervent.3n 


get service entry 


getw 


getc .3s 


get character or integer from stream 


getwd 


getwd.3 


get current working directory pathname 


gmtime 


ctime.3 


convert date and time to ASCII 


gtty 


8tty.3c 


set and get terminal state 


btonl 


byteorder.3n 


convert values between host and network byte order 


htpns 


byteorder.3n 


convert values between host and network byte order 


index 


8tring.3 


string operations 


inet_adidr 


inet.Sn 


Internet address manipulation 
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inetjinaof inet.Sn Internet address manipulation 

inet_makeaddr inet.3n Internet address manipulation 

inet.netof inet.3n Internet address manipulation 

inet_network inet.3n Internet address manipulation 

inet_ntoa inet.3n Internet address manipulation 

initgroups initgroups.S initialize group access list 

initstate random.3 better random number generator; routines for changing generators 

insque in8que.3 insert/remove element from a queue 

isalnum ctype.3 character classification macros 

isalpha ctype.3 character classification macros 

isascii ctype.3 character classification macros 

isatty ttyname.3 find name of a terminal 

iscntrl ctype.3 character classification macros 

isdigit ctype.3 character classification macros 

isgraph ctype.3 character classification macros 

isinf isinf.3 test for indeterminate floating point values 

islower ctype.3 character classification macros 

isnan isinf.3 test for indeterminate floating point values 

isprint ctype.3 character classification macros 

ispunct ctype.3 character classification macros 

isspace ctype.3 character classification macros 

isupper ctype.3 character classification macros 

Idexp frexp.3 split into mantissa and exponent 

locattiiiie ctime.3 convert date and time to ASCII 

longjmp 8etjmp.3 non-local goto 

malloc malloc.3 memory allocator 

mktemp mktemp.3 make a unique file name 

modf frexp.3 split into mantissa and exponent 

moncontrol monitor .3 prepare execution profile 

monitor monitor .3 prepare execution profile 

monstartup monitor .3 prepare execution profile 

nice nice.3c set program priority 

nlist nlist.3 get entries from name list 

ntohl byteorder.3n convert values between host and network byte order 

ntohs byteorder.3n convert values between host and network byte order 

opendir directory .3 directory operations 

openlog 8yslog.3 control ^stem log 

optarg getopt.Sc get option letter from argv 

optind getopt.3c get option letter from argv 

pause pause.3c stop until signal 

pclose popen.3s initiate I/O to/from a process 

perror perror.3 system error messages 

popen popen.3s initiate I/O to/from a process 

printf printf.3s formatted output conversion 

psignal psignal.3 system signal messages 

putc putc.3s put character or word on a stream 

putchar putc .3s put character or word on a stream 

puts puts.3s put a string on a stream 

putw putc.3s put character or word on a stream 

qsort qsort.3 quicker sort 

rand rand .3c random number generator 

random random.3 better random number generator; routines for changing generators 

rcmd rcmd.3n routines for returning a stream to a remote command 
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re_comp 


regex.3 


regular expression handler 


re_cxec 


regex.3 


regular expression handler 


readdir 


directory .3 


directory operations 


resdioc 


malloc.3 


memory allocator 


remque 


in8que.3 


insert/remove element from &q.«eiie 


rewind 


f seek .3s 


reposition a stream 


rewmddir 


dffectory.3 


directory^operations^ 


c^t«c 


rexec.3n 


return stream to a remote comnMod 


rifidex 


string.3 


string operations 


rresvport 


rcmd.3n 


routines for returning a stream to^m remote command 


rvserok 


rcind.3n 


routines for returning a stream ta» remote command 


scandir 


8candir.3 


scan a directoiy 


scanf 


seanf.Ss 


formatted input conversion 


seekdir 


directory .3 


directory c^erations 


setbnf 


setbuf.38 


assign ^iffertng to a stream 


eetbuffer 


setbuf.3s 


assfgn buffering to a^ stream 


setegid 


8etuid.3 


set user and group ID 


seteuid 


setaid.3 


set user and group ID 


setfeent 


getfsent.3 


get filcL system descriptor file entry 


setgid 


settiid.3 


set user and group H> 


setgrent 


getgrent.3 


get group file entry 


sethostent 


gethostent.Sn 


get network host entry 


setjmp 


setfinp.3^ 


non-local goto 


setkey 


crypt.3 


DES encryption 


setlinebuf 


8etbuf.3s 


asstgn buffering to a stream 


setQcteot 


getnetent.3n 


get network entry 


setprotoeat 


getprotoent.3n 


get protocol entry 


setpwent 


getpwent.3 


get password file entry 


setrgid 


setuid.3 


set user and group ID 


setruid 


8etuid.3 


set user and group ID 


setservent 


getservent.3n 


get service entry 


setstate 


random .3 


better random number generator; routines for changing generators 


setuid 


setuid.3 


set user and group ID 


signal 


signal.3 


simplified software signal facilRies 


sleep 


8leep.3 


suspend execution for interval 


sprintf 


printf.3s 


formatted output conversion 


srand 


rand .3c 


random number generator 


srandom 


random.3 


better random number generator; routines for changing generators 


sscanf 


scanf.3s 


formatted input conversion 


stdio 


intro.3s 


standard buffered input/output package 


strcat 


string.3 


string operations 


strcmp 


8tring.3 


string operations 


strcpy 


8tring.3 


string operations 


strlen 


string.^ 


string operations 


strncat 


string.3 


string operations 


strncmp 


string.3 


string operations 


strncpy 


string.3 


string operations 


stty 


8tty.3q 


set and get terminal state 


swab 


swab.d 


swap bytes 


sysjerrlist 


perror.3 


system error messages 


sys_nerr 


perror.3 


system error messages 


sysjsiglist 


p8ignal.3 


system signal messages 


syslog 


syslog.S 


control system log 
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system 

telldir 

time 

times 

timezone 

tmpnam 

ttyname 

ttyslot 

ulimit 

ungetc 

utime 

valloc 

varargs 

vlimit 

vtimes 



system.3 issue a shell command 

directory .3 directory operations 

time.Sc get date and time 

times.3c get process times 

ctime.3 convert date and time to ASCII 

tmpnam.3c create a name for a temporary file 

ttyname.3 find name of a terminal 

ttyname.3 find name of a terminal 

ulimit.3c get and set user limits 

ungetc.38 push character back into input stream 

utime.Sc set file times 

valloc.3 aligned memory allocator 

varargs.3 variable argument list 

vlimit.Sc control maximum system resource consumption 

vtime8.3c get information about resource utilization 
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NAME 

abort - £en«rate a fault 

DESCRIPTION 

Abort executes ait instruction which is illegal in user mode. This causes a^ signal that norm^dly 
terminates the process with a core dump, which may be used for debuggisfir 

SEE ALSO 

adb(lS)^ <«ual(3^^ exit(2)^ 

DIAGNOSTICS 

Usually *l<yr trap - core dumped' from. the shelT^ 

BUGS 

Hie a6ori.f«ncti(» does not flu^stanc^od I/O buffers. Use ^9&-as described ia-felo9e{3S^^ 
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NAME 

abs - integer absolute value 

SYNOPSIS 

ab>(i) 
IntI; 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

SEE ALSO 

floor(3M) for /aia 

BUGS 

Applying the 060 function to the most negative integer generates a result which is the most neg»> 
tive integer. That is, abs(Qx80000000) returns 0x80000000 as a result. 
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NAME 

assert - program verification 

SYNOPSIS 

#inelude <luiscrt.h> 

aflBert(expr«Mtoii) 

DESCRIPTION 

A99ert is a macro tfitat indicates expression is expected to be tme at this point in the iMPOgram. It 
causes an exit{2) with a diagnosttc comment on the standard output when expreenon v^ false (0). 
Compiling with the cc(l) option -DNDEBUG effectively deletes asBtrt ttom thr program. 

MAONOSTTCS 

^Assertion tailed: file /Hne n. ' F is the source file and n the source line number of the o^^erfstate- 
mMit;. 
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NAME 

atof, atoi, atol - convert ASCII to numbers 

SYNOPSIS 

double atof(nptr) 
char *nptr| 

atoi(nptr) 
char *nptr; 

long atol(nptr) 
char *nptr} 

DESCRIPTION 

These functions convert a string pointed to by nptr to floating, integer, and long integer represen- 
tation respectively. The first unrecognized character ends the string. 

Atof recognizes an optional string of spaces, then an optional sign, then a string of digits option- 
ally containing a decimal point, then an optional 'e' or 'E' followed by an optionally signed 
integer. 

Atoi and atot recognize an optional string of spaces, then an optional sign, then a string of digits. 

SEE ALSO 

scanf(3S) 

BUGS 

There are no provisions for overflow. 

Currently, a<o/ performs highly inaccurate conversions of very large or very small numbers — on 
the order of 10**32 or its reciprocal. 
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NAME 

l>copy, bcmp, bzero, ffs - bit and byte string operations 

SYNOPSIS 

bcopy(bl, hZ, length) 
char *bl, *b2i 
hit length; 

bemp(bly b2, length) 
chap ♦bl, *b2| 
int length) 

bBero(b, length) 
char *b) 
!nt length) 

ffs(l) 
Int I; 

DESCRIPTION 

The functions beopjfy hemp, and hztro operate on variable l^igth strings of bytes. They do not 
check for null bytes as the routines in 8tring\^) do. 

Bcopu copies length bytes from string ht to the string h2. 

Bemp compares byte string hi against byte string hS, returning zero if they are identical, non-zero 
otherwise. Both strings are assumed to be length bytes long. 

Bzero places length bytes in the string h. 

Ffe finds the first bit set in the argument passed it and returns the index of that bit. Bits are 
numbered starting at 1 from the right. A return value of -1 indicates the value passed is zero. 



BUGS 



The bcmp ana heopy routines take parameters backwards from strcmp and strcpy. 
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NAME 

crypt, setkey, encrypt - DES encryption 

SYNOPSIS 

char '''crypt(key, salt) 
char *key, *8alt; 

setkey(key) 
char *keyi 

encrypt(block, edfiag) 
char *block) 

DESCRIPTION 

Crypt is the password encryption routine. It is based on the NBS Data Encryption Standard, with 
variations intended (among other things) to frustrate use of hardware implementations of the DES 
for key search. 

The first argument to erypt is normally a user's typed password. The second is a 2-character 
string chosen from the set [arzA-ZO-9./]. The «a/< string is used to perturb the DES algorithm in 
one of 4006 different ways, after which the password is used as the key to encrypt repeatedly a 
constant string. The returned value points to the encrypted password, in the same alphabet as 
the salt. The first two characters are the salt itself. 

The other entries provide (rather primitive) access to the actual DES algorithm. The argument of 
eetkey is a character array of length 64 containing only the characters with numerical vaJue and 
1. If this string is divided into groups of S, the low-order bit in each group is ignored, leading to 
a 56-bit key which is set into the machine. 

The argument to the encrypt entry is likewise a character array of length 64 containing O's and 
I's. The argument array is modified in place to a similar array representing the bits of the argu- 
ment after having been subjected to the DES algorithm using the key set by eetkey. If edflag is 0, 
the argument is encrypted; ii non-zero, it is decrypted. 

SEE ALSO 

passwd(l), passwd(5), login(l), getpass(3) 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

ctime, localtime, gmtime, asctime, timezone, dysize - convert date and time to ASCII 

SYNOPSIS 

char *etline(eIoek) 
long *ck>ck| 

#Include <tys/tlme.h> 

struct tm *localtlme(clock) 
long *elock^ 

strucVtm '''gmtime(claek) 
long *clock| 

char '*'aactlme(tm) 
struct tm Hmi 

char *tlmeione(Eonef dst) 

Int d]friBe(sr) 
Intyj 

DESCRIPTION 

Ctime converts a time pointed to by clock such as returned by getUmcofday{2) into ASCII and 
returns a pointer to a 2&*character string in the folloMring form. All the fields have constant 
width. 

Sun Sep 16 01:03:52 1973\n\0 

Locattime and gmtime return pointers to structures containing the broken-down time. Localtime 
corrects for the time zone and possible daylight savings time; gmtime converts directly to GMT, 
whkb is the time UNIX uses. Asctime converts a broken-down time to ASCII and returns a 
pointer to a 26-character string. 

The structure declaration from the include file ist 

struct tm { 

int tmjBec; 

int tmjnin; 

int tmjiour; 

int tmjmday; 

int tm_jnon; 

int tm_ycar; 

int tm_.wday^ 

int tm_yday; 

int tmjsdst; 

}: 

These qaan^ties give the time on a 24<^ottr clock^day of month (1^1), month of year (0-11)^, day 
of week (Sunday at 0), year - 1900, day of year (0-365), and a flag that is nonzero if daylight sav- 
ing time is fn ^effect. 

When local iittie is called for, the program consults the ^stem to determine the Ume zone and 
whether the tJ.S.A., Australian, Eastern European, Nfiddle European, or Western European day- 
light saving time adjustment is appropriate. The program knows about various peculiarities in 
time conversion over the |>ast 10-20 years. 

Timezone returns tne name of the time zone associated with its first argument, which is measured 
in minutes westward from Greenwich. If the second argument is 0, the standard name is used, 
otherwise the Daylight Saving version. If the required name does not appear in a table built into 
the routine, the difference from GMT is produced; e.g. in ASghaaist2si timezone('(60*4-f- ^0), 0) is 
appropriate because it is 4:30 ahead of GMT and the string GMT-h4:30 is produced. 
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Dysize returns the number of days in the argument year, either 365 or 366. 

SEE ALSO 

gettimeofday(2), time(3C) 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

isalpha, isupper, islower, fsdigit, isxdigit, isaJnum, hspace, ispunct, isprint, iscntrl^ isascii, isgraph, 
toupper, tolower, toascii - character classification and conversion mactos 

SYNOPSIS 

#iiiclude <ctype.h> 

i8alpha(c) 

• • • 

CHARACTER CLASSIFICATION MACROS 

These macros classify ASCII-coded integer values by table lookup. Each^ is a predicate returning 
nonzero tot true^ zero for false. Isasciiia defined on all integer values; the rest are defined only 
where isa8cii(c) is true and on the single non-ASCII value EOF (see 8tdio(3Slfl. 

isalphafc) e is a letter 

isupper(c) c ia an (^>per case letter 

islow«r(c) CIS a Tower case letter 

i8digit(c) ris^adigit 

isxdigit(e) e ir a hexadecimal digit 

i8alnum(e) c is an alphanumeric character 

i88pace(e) c is a space, tab, carriage return, newline, or formfeed 

i8punet(e) c is a punctuation character (neither control nor alphanumeric) 

isprtnt(c) e is a printing character, code 04(^8) (space) through 0176 (tilde) 

iscntrl(c) c is a delete character (0177) or ordinary control character (lesa than 040). 

isascii(c) c is an ASCII character, code less than 0200 

isgraph(e) c is a visible graphic character, code 041 (exclamation marie) through 0176 (tilde). 

CHARACTER CONVERSION MACROS 

These macros perform simple conversicms on single characters^. 



toupper(c) 



tolower(e) 



toa8cii(c) 

Sia&ALSO 

a8cii(7^ 



converts c to its upper-case equivalent. Note that th» onty works where c is 
known to be a lower-case character to start witt (presumably checked via 
islower). 

converts c to its lower-case equivalent. Note that this anly wcHrks where c is 
knawn to be a upper-case character ta start with (presunsably checked via 
isupper)^ 

masks c with the correct value so that c is guaranteed to be an ASCII character 
in the range thru Ox7f. 
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NAME 

opendir, readdir, ttelldir, seekdir, rewinddir, closcdir - dircctoiy operations 

SYNOPSIS 

#include <8y8/d!?^h> 

DIR *opendir(fllename) 
chttr *fllenam«| 

|truet direct *readdir(dirp) 
piRMIrpi 

long teUdir(dlrp) 
DIR^dirpi 

■eekdlr(dlrp, loe) 
DIR*dirp| 
long loci 

reiviiuldlr(dirp) 
DIR*dirp| 

cloiedir(dirp) 
IMR ♦dlrpi 

DESCRIPTION 

Opendir opens the directory named by filename and associates a directory stream vfith it. Opendir 
returns a pointer to be used to identify the directory stream in subsequent operations. The 
pointer NULL is returned if filename cannot be accessed or is not a directoiy, or if it cannot mal- 
loc{3) enough memory to hold the whole thing. 

Readdir returns a pointer to the next directory entry. It returns NULL upon reaching the end of 
the directoiy or detecting an invalid seekdir operation. 

Telldir returns the current location associated with the named directory stream. 

Seekdir sets the position of the next readdir operation on the directory stream. The new position 
reverts to the one associated with the directory stream when the telldir operation was performed. 
Values returned by telldir are good only for the lifetime of the DIR pointer from which they are 
derived. If the directory is closed and then reopened, the telldir value may be invalidated due to 
undetected directory compaction. It is safe to use a previous telldir value immediately after a call 
to opendir and before any calls to readdir. 

Rewinddir resets the position of the named directory stream to the beginning of the directory. 

Closedir closes the named directory stream and frees the structure associated with the DIR 
ipointert 

Sample code which searchs a directory for entry "name" is: 

len a 8trlen(name); 
dirp =a opendirC."); 
for (dp aa readdir(dirp); dp != NULL; dp =s readdir(dirp)) 

if (dp->d.namlen —^^s len && !strcmp(dp->d_name, name)) { 
closedir(dirp); 
return FOUND; 

} 
closed ir(dirp); 

return NOT_FOUND; 

SEE ALSO 

open(2), close(2), read(2), lseelc(2), dir(5) 
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BUGS 

Old UNIX programs which examine directories should be converted to use this package, as the 
new directory format is non-obvious. 
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NAME 

ccvt, fcvt, gcvt - output conversion 

SYNOPpS 

<shar *ecvt(value, ndigit, decpt, sign) 

double value; 

l^it ndigit, *decpty ^sign} 

char *fevt(valuey ndigit, decpt, sign) 

double value; 

int ndi^t, *decpt, '"■ign; 

char *gcvt(value, ndigit, buf) 
double value; 
char *buf; 

DESCRIPTION 

Ecvt converts the value to a nuU-tenninated string of ndigit ASCII digits and returns a pointer 
thereto. The position of the decimal point relative to the beginning of the string is stored 
indirectly through decpt (negative means to the left of the returned digits). If the sign of the 
result is negative, the word pointed to by sign is non-zero, otherwise it is zero. The low-order 
digit is rounded. 

Fcvt is identical to ecvt, except that the correct digit has been rounded for Fortran F-format out- 
put of the number of digits specified by ndigita. 

Gcvt converts the value to a null-terminated ASCII string in huf and returns a pointer to buj. It 
attempts to produce ndigit significant digits in Fortran F format if possible, otherwise E format, 
. ready for printing. Trailing zeros may be suppressed. 

SEE aLsO 

i8inf(3), printf(3S) 

BUG^ 

The return values point to static data whose content is overwritten by each call. 
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NAME 

end, etext, edata - last locations in program 

SYNOPSIS 

extern end) 
extern etext; 
extern edata; 

DESCRIPTION 

These names refer nekber to routines nw to locations with interestinf^ ccmtents. The address of 
etezt is the first address above the program text, edata above the initialited data, region, and end 
above the uninitialized data region. 

When execution begins, the program break coincides with end, but it is-reset by the routines 
l^rk[2), ma//oc(3),^ standard input/output {atdio{ZS)}f the profile (-p) option of ee{l), etc. The 
current value of the program break is reliably returned by 'sbrk(O)', see brk{2). 

SEE ALSO 

brk(2), maUoc(3) 
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NAME 

excel, execv, execle, cxeclp, exccvp, environ - execute a file 

SYNOPSIS 

^xecl(name, argO, argl» .,»$ argn, 0) 
char *name, *argO» *argl, ...» *argii| 

execv(name, argv) 
char *name, *argv[ ]; 

execle(name, argO, argl, ...» argn, 0, envp) 
char *name, *argO, *argl, ..., *argn, *envp[ ]; 

execlp(name, argO, argl, ..., argn, 0, envp) 
char *name, *argO, *argl, ..., *argn, *envp[ ]; 

execvp(name, argv, envp) 
char *name, *argv[ ], *envp[ ]| 

extern char ""^envbon; 

DESCRIPTION 

These routines provide various interfaces to the execve system call. Refer to execve{2) for a 
description of their properties; only brief descriptions are provided here. 

Exec in all its forms overlays the calling process with the named file, then transfers to the entry 
point of the core image of the file. There can be no return from a successful exec; the calling core 
image is lost. 

The name argument is a pointer to the name of the file to be executed. The pointers arir(0], 
argil] ... address null-terminated strings. Conventionally ar^|(7) is the name of the file. 

Two interfaces are available, execl is useful when a known file with known arguments is being 
called; the arguments to execl are the character strings constituting the file and the arguments; 
the first argument is conventionally the same as the file name (or its last component). A argu- 
ment must end the argument list. 

The execv version is useful when the number of arguments is unknown in advance; the arguments 
to execv are the name of the file to be executed and a vector of strings containing the arguments. 
The last argument string must be followed by a pointer. 

When a C program is executed, it is called as follows: 

main(argc, argv, envp) 

int argc; 

char **argv, ♦♦envp; 

where argc is the argument count and argv is an array of character pointers to the arguments 
themselves. As indicated, argc is conventionally at least one and the first member of the array 
points to a string containing the name of the file. 

Argv is directly usable in another execv because argv[arge] is 0. 

Envp is a poinUr to an arra)^ bt strings that cohstitute the environment of the process. Each 
string consists of a name, an "ss", and a null-terminated value. The array of pointers is ter- 
minated by a null pointer. The shell 8h{l) passes an environment entry for each global shell vari- 
able defined when the program b call^. See environ{5) for some conventionally used names. 
The C run^time start-off routine places a copy of envp in the global cell entnron, which is used by 
execv and execl to pass the environment to any subprograms executed by the current prograni. 

Execlp and execvp are called with the same arguments as execl and execv, but duplicate the shell's 
actions in searching for an executable file in a list of directories. The directory list is obtained 
from the environment. 
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FILES 

/bin/sh shell, invoked if commaild file found by execlp or exeevp 

SEE ALSO 

execve(2), fork(2), environ(5), csh(l), sh(l) 

"UNIX Programming" in Programming Tootafor the SUN Workstatiort, pp, 1-3. 

DIAGNOSTICS 

If the file cannot be found, if it is not executable, if it does not start with a valid magic Dumber 
(see a.out{b)), if maximum memory is exceeded, or if the arguments^ require too much space, a 
return constitutes the diagnostic; the return value is -1. Even for the super-user, at least one of 
the execute-permission bits must be set for a file to be executed. 

BUGS 

It eticvp is cabled, to execute a file that turns out to be a shell command file, and if it is impossi- 
ble to execute the shell, the values^ of argvfOj and ar gvf-1 J wiW be modified before return^ 
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NAME 

exit - tenninate a process after flushing any pending output 

SYNOPSIS 

exit(statui) 
int statui} 

DESCRIPTION 

Exit terminates a process by calling exit{2) after calling the Standard I/O library function 
^cleanup to flush any buffered output. Exit never returns. 

SEE ALSO 

exit(2), intro(3S) 
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NAME 

frexp, Idexp, modf - split into mantissa and exponent 

SYNOPSIS 

double f^exp(value, eptr) 
double valuei 
Int ""eptri 

double ldexp(value» exp) 
double valuei 

double modf(value, Iptr) 
double viJue, *lptr) 

DESCRIPTION 

Frexp returns the mantissa of a double value as a double quantity, z, of magnitude less than 1 and 
stores an integer n such that value =s x*2^ indirectly through eptr. 

Liezp returns the quantity value* 2^^^. 

Modf retuTUB the positive fractional part of value and stores the integer part indirectly through 
iptr, 

SEE ALSO 

isinf(3) 

BUGS 

The identity claimed for the results of frexp cannot hold when the value argument is an lEEIE 
indefinite quantity — infinity or not-a-number. 
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NAME 

getdate - convert time and date from ASCn 

SYNOPSIS 

#lnclude <my»/typemM> 
^include <tyi/timeb^h> 

f Imejt getdate(buf, now) 
char ^buf; 

struct timeb *now; 

DESORIPTION 

Getdate converts most common time specifications to standard UNIX format. The first argument 
is the character string containing the time and date; the second is the assumed current time (used 
for relative specifications); if NULL is passed, ftime{2) is used to obtain the current time and 
timezone. 

The character string consists of or more specifications of the following form: 

tod A tod is a time of day, which is of the form hhimml.ss] (or hhmm) Imeridian] [zone]. If 
no meridian - am or pm - is specified, a 24-hour clock is used. A tod may be specified as 
just M followed by a meridian. 

date A date is a specific month and day, and possibly a year. Acceptable formats are 
mm/dd[/yy] and monthname dd\, yy] If omitted, the year defaults to the current year; if a 
year is specified as a number less than 100, 1900 is added. If a number not followed by a 
day or relative time unit occurs, it will be interpreted as a year if a tod, monthname, and 
ddhxve already been specified; otherwise, it will be treated as a tod. This rule allows the 
output from date(l) or ctime{Z) to be passed as input to getdate. 

day A day of the week may be specified; the current day will be used if appropriate. A day 
may be preceeded by a number, indicating which instance of that day is desired; the 
default is 1. Negative numbers indicate times past. Some symbolic numbers are 
accepted: lait, next, and the ordinals first through twelfth (second is ambiguous, and 
is not accepted as an ordinal number). The symbolic number next is equivalent to 2; 
thus, next monday refers not to the immediately coming Monday, but to the one a week 
later. 

relative time 

Specifications relative to the current time are also accepted. The format is [numfter] unit; 
acceptable units are year, month, fortnight, week, day, hour, minute, and second. 

The actual date is formed as follows: first, any absolute date and/or time is processed and con- 
verted. Using that time as the base, day-of-week specifications are added; last, relative 
specifications are used. If a date or day is specified, and no absolute or relative time is given, 
midnight is used. Finally, a correction is applied so that the correct hour of the day is produced 
after allowing for daylight savings time differences. 

Getdate accepts most common abbreviations for days, months, etc.; in particular, it recognizes 
them with upper or lower case first letter, and recognizes three-letter abbreviations for any of 
them, with or without a tra;iling period. Units, such as weeks, may be specified in the singular or 
plural. Timezone and meridian values may be in upper or lower case, and with or without 
periods. 

FILES 

/u8r/lib/tibu.a 

SEE ALSO 

ctime(3), time(2) 
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BUGS 

Because jiacc{l) is used to parse the date, getdate cannot be used a subroutine to any program 

that also needs yaee. 

The grammar and scanner are rather primitive; certain desirable and unambiguous constructions 

are not accepted. Worse yet, the meaning of some legal phrases is not what is expected; next 

week is identical to 2 weeks. 

The daylight savings time correction is not perfect, and can get confused if handed times between 

midnight and 2:00 am on the days that the reckoning changes. 

Because locaUime{2) accepts an old-style time format without zone information, attempting to 

pass getdate a current time containing a different zone will probably fail. 
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NAME 

getenv - value for environment name 

SYNOPSIS 

char *getenv(name) 
char *name| 

DESCRIPTION 

Getenv searches the environment list (see environ{5)) for a string of the form name^isvalue and 
returns a pointer to the string value if such a string is present, otherwise getenv returns the value 
(NULL). 

SEE ALSO 

environ (5), execve(2) 
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NAM£ 

getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent - get file system descriptor file entry 

SYNOPSIS 

#lnelude <fBtab.h> 

struct fstab *getfBent() 

struct fstab *getfsspec(spee) 
char *specj 

struct fstab *getfsflle(flle) 
char "'filei 

struct fstab *getfstype(type) 
char *type| 

Int setfsentQ 
Int endJhentO 

DESCRIPTION 

Getf9ent, getfaepee, getfetype, and getfsfile each return a pointer to an object with the following 
structure containing the broken-out fields of a line in the file system description file, <f8tab.h>. 

struct fstab { 

char *f5j5pec; 

char *f8_file; 

char *f»_typc; 

int fsjTreq; 

int fs^passno; 

}; 

The fields have meanings described in f8tab{S), 

Getfaent reads the next line of the file, opening the file if necessary. 

Set/sent opens and rewinds the file. 

Endfaeni closes the file. 

Getfaapee and getfafiie sequentially search from ther beginning of the file until a matching special 
file name or file cistern file nune is fovnd, or until EOF is encountered. Getfatype does likewise, 
matching on the file system type field. 

FILES 

/etc/fstab 

SEE ALSO 

fstsb(S)^ 

MAGNOSTICS 

NttB powter (0)rretQrned on EC^ or etros. 

BUGS 

The return valve p<»nt8 to static mfotmation which k overwritten m each eatt. 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent - get group file entry 

SYNOPSIS 

#iiiclude <grp.h> 

struct group *getgreiitO 

struct group *getgrgid(gid) 
int gld; 

struct group *getgrnam(name) 
char *name| 

setgrent 

endgrentQ 

DESCRIPTION 

Getgrent, getgrgid vnA getgrnam each return pointers to an object with the following structure 
cc»ntaining the broken-out fields of a line in the group file: 

struct group { 

char *gr_iiame; 
char *grj)as8wd; 
int gr^id; 
char **gr_mem; 

}; 

The members of this structure are: 

gr_name The name of the group. 

gr_j)as8wd The encrypted password of the group. 

gr_gid The numerical group-ID. 

gr_mem Null-terminated vector of pointers to the individual member names. 

Getgrent simply reads the next line while getgrgid and getgrnam search until a matching gid or 
name is found (or until EOF is encountered). Each routine picks up where the others leave off so 
successive calls may be used to search the entire file. 

A call to eetgrent has the effect of rewinding the group file to allow repeated searches. Endgrent 
may be called to close the group file when processing is complete. 

FILES 

/etc/group 

SEE ALSO 

ge|login(3), getpwent(3), group(5) 

DIAGNOSTICS 

A null pointer (0) is returned on EOF or error. 

BUGS 

The return value points to static information which is overwritten on each call. 
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NAME 

getlogin - get login name 

SYNOPSIS 

char *getloghiO 

DESCRIPTION 

Getlogin returns a pointer to the login name as found in /etc/utmp. It may be used in conjunc- 
tion with getpwnam to locate the correct password file entry when the same userid is shared by 
several login names. 

If getlogin is called within a process that is not attached to a typewriter, it returns NULL. The 
correct procedure for determining the login name is to first call getlogin and if it fails, to call 
getpwuid{getuid{)). 

FILES 

/etc/utmp 

SEE ALSO 

getpwent(3), getgrent(3), utmp(5) 

DIAGNOSTICS 

Returns NULL (0) if name not foundr 

BUGS 

The return values point to static data whose content is overwritten by each call. 

Getlogin does not work for processes running under a pty (for example, emacs shell buffers, or shell 
toob) unless the program "fakes" the login name in the f etc/utmp file. 
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NAME 

getpass - read a password 

SYNOPSIS 

char *getpas8(prompt) 
char ^prompti 

DESCRIPTION 

Getpass reads a password from the file /dev/tty, or if that cannot be opened, from the standard 
input, after prompting with the null-terminated string prompt and disabling echoing. A pointer is 
returned to a null-terminated string of at most 8 characters. 

FILES 

/dev/tty 

SEE ALSO 

crypt(3) 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

getpw - get name from uid 

SYNOPSIS 

getpw(uid, buf) 
char "'huti 

DESCRIPTION 

Getpw la obsoleted by getpwent(3). 

Getpw searches the password file for the (numerical) uid, and fills in buf with the corresponding 
line; it returns non-zero if uid could not be found. The line is null-terminated. 

FILES 

/etc/passwd 

SEE ALSO 

getpwent(3), pas8wd(5) 

DIAGNOSTICS 

Non-zero return on error. 
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NAME 

getwd - get current working directory pathname 

SYNOPSIS 

#lnelude <ay8/parain.h> 

char *getwd(pathname) 

char pathnaine[MAXPATHLEN]| 

DESCRIPTION 

Getwd copies the absolute pathname of the current working directory to pathname and returns a 
pointer to the result. 

DIAGNOSTICS 

Getwd returns zero and places a m^&sage in pathname if an error occurs. 

BUGS 

Getwd may fail to return to the current directory if an error occurs. 
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NAME 

initgroups - initialize group access list 

SYNOPSIS 

lnltgroup8(name, baiegld) 
ehar *iiame; 
lot basegld} 

DESCRIPTION 

Initgroups reads through the group file and sets up, using the 8etgroup8{2) call, the group access 
list for the user specified in name. The basegid is automatically included in the groups list. Typi- 
cally this value is given as the group number from the password file. 

FILES 

/etc/group 

SEE ALSO 

8etgroiips(2) 

DIAGNOSTICS 

Initgroups returns -1 if it was not invoked by the super-user. 

BUGS 

InitgroupB uses the routines based on getgrent{S). If the mvoking program uses any of these rou- 
tines, tht group structure will be overwritten in the call to initgroups, 

Noone seems to keep /etc/group up to date. 
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NAME 

iii8qu«^ remque - inseii/reinoye element ^om a qiieue 

SYNOPSIS 

■tru^i qelem { 

ckruet qelem *q_|Qirfi| 
struct qelem *q_back| 
chftr q_^ttftQ| 

h 

In8que(elemy pred) 
struct qelem *elem» *pred} 

remque(i^lem) 
struct qelem ""eleiiii 

DESCRIPTION 

Insque and remque manipulate queues built from doubly linked lists. Each element in the queue 
must be in the form of "struct qelem". Intque inserts elem in a queue imediately after pred; 
remque removes an entry elem from a queue. 

SEE ALSO 

"VAX Architecture Kan4hpok", pp. 228-235. It docs work on SUNS. 
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NAME 

isinf, isDan - test for indeterminate floating point values 

SYNOPSIS 

Int l6laf(value) 
double value} 

Int Isnaii(value) 
double valuei 

DESCRIPTION 

hinf returns a value of 1 if its value is an IEEE format infinity (two words 0x7ff00000 
OxO(K)00000) or an IEEE negative infinity, and returns a zero otherwise. 

hnan returns a value of 1 if its value is an IEEE format 'not-a-number' (two words 
0x7f nnnnnOx nnnnnnnn) where n is not zero) or its negative, and returns a zero otherwise. 

Some library routines such as ecvt{2) do not handle indeterminate floating point values gracefully. 
Prospective arguments to such routines should be checked with isinf or isnan before calling these 
routines. 

BUGS 

Need a manual section describing the format of IEEE numbers in detail. 
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NAME 

malloc, free, rcalloc, calloc, cfrec, alloca - memory allocator 

SYNOPSIS 

char *malloc(8ixe) 
untlgned tise) 

fliree(ptr) 
char *|>tr| 

char *realloc(ptr, sIm) 
char ""ptri 
unsigned sisei 

char '''calloc(nelemy eblse) 
unsigned nelem* elsUe) 

cfree(ptr) 
char *ptr| 

char *alloca(sUe) 
Int slxei 

maUoc_pk(sise) 
Int slse} 

DESGRIPTION 

Malloc and free provide a general-purpose memory allocation package. Malloe returns a pointer to 
a block of at least tize bytes beginning on a wofd boundary. 

The argument to free is a pointer to a block previously allocated by mattoe; tbis space is made 
available for further allocation, but its contents are left undisturbed. 

Needless to say, grave disorder will result if the space assigned by mathc is overrun or if some 
random number is handed to free. 

Malloc maintains a cartesian tree of free blocks. It calls sbrk (see hrk{2)) to get more memory 
from the system when there is no suitable space already free. 

Realloe changes the size of the block pointed to by ptr to size bytes and returns a pointer to the 
(possibly moved) block. The contents will be unchanged up to the lesser of the new and old sizes. 

Realloe also works if ptr points to a block freed since the last call of malloc, reaUoc or catloe. 

Calloc allocates space for an array of nelem elements of size etsize. The space is initialized to 
zeros, and csuoi be freed with cfree. 

Alloca allocates me bytes of space in the stack frame of the caller. This temporary space is 
automatically freed on return. 

Ocassionally a program will overun the storage allocated from Malloc . Malloc^ok helps determine 
when thu has happened. It checks all blocks (free or allocated) looking for duplicates, strange 
addreKes and absurd sizes. Malloc__ok returna true if everything is is found. The size parameter 
specifies the maximum acceptable size of a block. A block with a larger size is considered bad. If 
size is zero a maximum of 10000 is assumed. 

Each of the allocation routines returns a pointer to space suitably aligned '(after possible pointer 
cocrcioii) for storage of any type of object. 

SEE Al/SO 

Fast Fits hy C. J. Stephenson 

DIAGNOSTIGS 

Malloc, realloe Bad calloc return a null pointer (0) if there is no available memory <Mr if the arena 
has been detectably corrupted by storing outside the bounds of a block. 
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BUGS 

When reaUoe returns 0, the block pointed to by ptr may be destroyed. 

Alio CO is machine dependent; it's use is discouraged. 
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NAME 

mktemp - make a unique file name 

SYNOPSIS 

char '''inktemp(templ&te) 
char 'template; 

DESCRIPTION 

Mktemp replaces template by a unique file name, and returns the address of the template. The 
template should look like a file name with six trailing X's, which will be replaced with the current 
process id and a unique letter. 

Notei: 

• Mktemp actually changes the template string which you pass, this means that you cannot use 
the same template string more than once — you need a fresh template for every unique file you 
want to open. 

• When mktemp is creating a new unique filename it checks for the prior existence of a file with 
that name. This means that if you are creating more than one unique filename, it is bad prac- 
tice to use the same root template for multiple invocations of mktemp. 

SEE ALSO 

getpid(2) 



3^ Last change: 6 January 1984 Sun Release 1.1 



MONITOR (3) SUBROUTINES MONITOR (3) 



NAME 

monitor, monstartup, moncontrol - prepare execution profile 

SYNOPSIS 

monltor(lowpey highpc, buffer, bufsise, nftinc) 
int (♦lowpc)(), (*h!8hpc)(), 
short buffer D; 

monitartup(lowpe, hlghpc) 
Int (*lowpc)(), (*highpc)(), 

moneontrol(mod«) 

DESCRIPTION 

There are two different forms of monitoring available: An executable program created by: 

cc -p . . . 

automatically includes calls for the pro/(l) monitor and includes an initial call to its start-up rou- 
tine monstartup with default parameters; monitor need not be called explicitly except to gain fine 
control over profil buffer allocation. An executable program created by: 

cc -pf . . . 

automatically includes calls for the gprof{l) monitor. 

Monstartup is a high level interface to profii{2). Lowpc and highpe specify the address range that 
is to be sampled; the lowest address sampled is that of lowpc and the highest is just below highpe. 
Monstartup allocates space using 8hrk{2) and passes it to monitor (see below) to record a histo- 
gram of periodical^ sampled values of the program counter, and of counts of calls of certain func- 
tions, in the buffer. Only calls of functions compiled with the profiling option -p of cc(l) are 
recorded. 

To profile the entire program, it is sufficient to use 

extern etext(); 

monstartup(Qx8000, etext); 
Ettxt lies just above all the program text, see tnd{Z), 
To stop execution monitoring and write the results on the file mon.oxtt, use 

monitor(O); 

then prof(\) can be used to examine the results. 

Moncontrol is used to selectively control profiling within a program. This works with either 
p^roj(\\ot 9proJ{\) type profiling. When the program starts, profiling begins. To stop the collec- 
tion of histogram ticks and call counts use moncontrol{fi)\ to resuioe the collection of histogram 
ticks and call counts use monc(yntrol(\). This allows the cost of particular operations to be meas- 
ured. Note that an output file will be produced upon program exit trregardless^ of the state of 
moncontrol. 

Monitor is a low level interface to profit^), Lowpc and highpe are the addresses of two functions; 
buffer is tbe address of a (user supplied) array ot bufaize short integers. At most nfune call counts 
can be kept. For the results to be significant, especially where th^re are small, heavily used rou- 
tines, it is suggested that the buffer be no more than a^ few times tmaUer than the range of kica- 
tions sampled. Monitor divides the buffer into space to recOTd the histogram of program counter 
samples over the range lowpc to highpe, and space to record call count»of functions compiled with 
the -p option to cc(l). 

To profile the entire program, it is sufficient to use 
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extern etext(); 

niPiiilbor(Qx8000, etext, buf, bulsize, nfune); 

fii.es 

mQD.out 

SEE ALSO 

cc(l), prof(l), gprof(l), profil(2), 8brk(2) 
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NAME 

nlist - get entries from name list 

SYNOPSIS 

#lneludo <nU8t.h> 

nliit(fllenamei nl) 
char *fllenftme| 
■truet nlbt nl{]; 

DESCRIPTION 

Nliat examines the name list in the given executable output file and selectively extracts a list of 
values. The name list consists of an array of structures containing names, types and values. The 
list is terminated with a null name. Each name is looked up in the name list of the file. If the 
name is found, the type and value of the name are inserted in the next two fields. If the name is 
not found, both entries are set to 0. See a.out{5) for the structure declaration. 

This subroutine is useful for examining the i^stem name list kept in the file /vmunix. In this 
way programs can obtain system addresses that are up to date. 

SEE ALSO 

a.out(5) 

DIAGNOSTICS 

All type entries are set to if the file cannot be found or if it is not a valid namelist. 
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NAME 

perror, sysjerrlist, sysjaerr, crrno - system error messages 

SYNOPSIS 

perror(s) 
char *■! 

Int ■yi_nerr) 
char *iyfjerrlLit[]) 

Int errno) 

DESCRIPTION 

Perror produces a short error message on the standard error file describing the last error encoun- 
tered during a call to the ^stem from a C program. First the argument string » is printed, then 
a colon, then the message and a new-line. Most usefully, the argument string is the name of the 
program which incurred the error. The error number is taken from the external variable errno 
(see intro{2)), which is set when errors occur but not cleared when non-erroneous calls are made. 

To simplify variant formatting of messages, the vector of message strings sysjerrlist is provided; 
errno can be used as an index in this table to get the message string without the newline. 
Sysjnerr is the number of messages provided for in the table; it Should be checked because new 
error codes may be added to the system before they are added to the table. 

SEE ALSO 

in(ro(2), psignal(3) 



^2 Last change: 19 January 1^33 Sun Release 1.1 



PSIGNAL(3) SUBROUTINES PSIGNAL(3) 



NAME 

pslgaal, ^sjsigiist - system signal messages 

SYNOPSIS 

palgnal(8ig, s) 
unsigned sig} 
char *8) 

char *8yijilgll8t[]} 

DESCRIPTION 

Peignal produces a short message on the standard error file describing the indicated signal. First 
the argument string 9 is printed, then a colon, then the name of the signal and a new-line. Most 
usefully, the argument string is the name of the program which incurred the signal. The signal 
number should be from among those found in <8ignal.h>. 

To simplify variant formatting of signal names, the vector of message strings sysjBiglist is pro- 
vided; the signal number can be used as an index in this table to get the signal name without the 
newline. The define NSIG defined in <8ignal.h> is the number of messages provided for in the 
table; it should be checked because new signals may be added to the system before they are added 
to the table. 

SEE ALSO 

perror(3), 8ignal(3) 
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NAME 

qsort - quicker sort 

SYNOPSIS 

q8ort(ba8e, nel, width, compar) 
char *ba8e; 
hat (*compar)(); 

DESCRIPTION 

Qsort is an implementation of the quicker-sort algorithm. The first argument is a pointer to the 
base of the data; the second is the number of elements; the third is the width of an element in 
bytes; the last is the name of the comparison routine to be called with two arguments which are 
pointers to the elements being compared. The routine must return an integer less than, equal to, 
or greater than according as the first argument is to be considered less than, equal to, or greater 
than the second. 

SEE ALSO 

sort(I) 
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NAME 

random, srandom, initstate, setstate - better random number generator; routines for changing 
generators 

SYNOPSIS 

long randomQ 

8random(seed) 
Int seed) 

long *inlt8tate(Beed, •tate, n) 
unsigned seedi 
long *«tate| 
int ni 

long '''8et8tate(Btate) 
long *8tate| 

DESCRIPTION 

Random uses a non-linear additive feedback random number generator employing a default table 
of size 31 long integers to return successive pseudo-random numbers in the range from to 2^^-l. 
The period of this random number generator is very large, approximately 16*(2 ^-1). 

Random/ erandom have (almost) the same calling sequence and initialization properties as 
rand/erand. The difiference is that rand{3C) produces a much less random sequence — in fact, the 
low dozen bits generated by rand go through a cyclic pattern. All the bits generated by random 
are usable. For example, "random()£;01" will produce a random binary value. 

Unlike Brand, erandom does not return the old seed; the reason for this is that the amount of state 
information used is much more than a single word. (Two other routines are provided to deal with 
restarting/changing random number generators). Like rand{ZC), however, random will by default 
produce a sequence of numbers that can be duplicated by calling srandom with 1 as the seed. 

The initstate routine allows a state array, passed in as an argument, to be initialized for future 
use. The size of the state array (in bytes) is used by initttatt to decide how sophisticated a ran- 
dom number generator it should use — the more state, the better the random numbers will be. 
(Current "optimal" values for the amount of state information are 8, 32, 64, 128, and 256 bytes; 
other amounts will be rounded down to the nearest known amount. Using less than 8 bytes will 
cause an error). The seed for the initialization (which specifies a starting point for the random 
number sequence, and provides for restarting at the same point) is also an argument. Initstate 
returns a pointer to the previous state information array. 

Once a statd nas been initialized, tne setstate routine provides for rapid switching between states. 
Setstate returns a pointer to the previous state array; its argument state array is used for further 
random number generation until the next call to initstate or setstate. 

Once a state array has been initializlHl li may be restarted at a different point either by calling 
initstate, {with the desired seed, the state array, and its size) or by calling both setstate (with the 
state arr^y) and srandom (with the desired seed). The advantage of calling both setstate and 
srandom is that the sitt of the state array does not have to be remembered after it is initialized. 

With i^i bytes of kl|ii4|miormation, the period of the random number generator is greater than 



^ 2^, whiei should be i^Mcltskt for most |)*irposes. 

blAdNOSTICS 

If ftitstah is called with less than 8 bytes of state information, or if setstate detects that the state 
information has been garbled, error messages are printed on the standard error output. 

SEE ALSO 

rand(3C) 
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BUGS 

About 2/3 the speed of rand{ZC). 
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NAME 

rejcomp, re_cxec - regular expression handler 

SYNOPSIS 

char *re_comp(8) 
char *8) 

re_exec(8) 
char *■! 

DESCRIPTION 

Rejcomp compiles a string into an internal form suitable for pattern matching. Re_ezec checks 
the argument string against the last string passed to re_coTnp. 

Rejcomp returns if the string s was compiled successfully; otherwise a string containing an error 
message is returned. If rt_comp is passed or a null string, it returns without changing the 
currently compiled regular expression. 

Rtjtxtc returns 1 if the string 8 matches the last compiled regular expression, if the string 8 
failed to match the last compiled regular expression, and >1 if the compiled regular expression was 
invalid (indicating an internal error). 

The strings passed to both rt__comp and rtjtxec may have trailing or embedded newline charac- 
ters; they are terminated by nulls. The regular expressions recognized are described in the 
manual entry for td{\), given the above difference. 

SEE ALSO 

ed(l), ex(l), cgrep(l), fgrep(l), grep(l) 

DIAGNOSTICS 

Rejexee returns -1 for an internal error. 

Rejcomp returns one of the following strings if an error occurs: 

No previous regular expreaeion 

Regular expreeeion too long 

unmatched\( 

missing] 

too many \(\) pairs 

unmatched \) 
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NAME 

scandir, alphasort - scan a directory 

SYNOPSIS 

#include <sy>/typeB.h> 
#lnelude <sys/dir.h> 

■candlr(dlrname, nameliitf select, compar) 

char *dlrname| 

■truct direct *(*nameliatD)| 

lot (*Mlect)Q} 

Int ('''coinpar)()| 

alpha8ort(dl, d2) 
struct direct **dl, **d2| 

DESCRIPTION 

Scandir reads the directory dirname and builds an array of pointers to directory entries using mal- 
/oc(3). The third parameter is a pointer to a routine which is called with a pointer to a directory 
entry and should return a non zero value if the directory entry should be included in the array. If 
this pointer is null, then all the directory entries will be included. The last argument is a pointer 
to a routine which is passed to q8ort{3) to sort the completed array. If this pointer is null, the 
array is not sorted. Alphasort is a routine which will sort the array alphabetically. 

Scandir returns the number of entries in the array smd a pointer to the array through the parame- 
ter namelist. 

SEE ALSO 

directory(3), malloc(3), qsort(3) 

DIAGNOSTICS 

Returns -1 if the directory cannot be opened for reading or if maUoc{Z) cannot allocate enough 
memory to hold all the data structures. 
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NAME 

setjmp, longjmp - non-local goto 

SYNOPSIS 

#liiclude <8e4Jnip.h> 

val sa 8etjinp(env) 
Jmp_buf env) 

longJmp(enyy val) 
Jmpjbuf envi 

val <BB _setjrap(env) 
Jmpjbuf env) 

JioiigJiEip(eiiVr val) 
Jmpjbuf envi 

DESCRIPTION 

Setjmp and longjmp are useful for dealing with errors and interrupts encountered in a low>level 
subroutine of a progranii 

Setjmp saves its stack environmeni in env for later use by longjmp. Setjmp also saves the register 
environment. Setjmp returns the value 0. If a longjmp call will be made, the routine which called 
setjmp should not return until after the longjmp has returned control (see below). 

Longjmp restores the environment saved by the last call of setjmp, and then returns in such a 
way that execution continues as if the call of setjmp had just returned the value vd to the func- 
tion that invoked setjmp. The calling function must not itself have returned in the interim, oth- 
erwise longjmp will be returning control to a possibly non-existent environment. All memory- 
bound data have values as of the time longjmp was called. The machine registers are restored to 
the values they had at the time that setjmp was called. But, because the register storage class is 
only a hint to the C compiler, variables declared as register variables may not necessarily be 
assigned to machine registers, so their values are unpredictable after a longjmp. This is especially 
a problem for programmers trying to write machine-independent C routines. 

The following code fragment indicates the Sow of control of the setjmp and /on^jfrnp combination: 

. . . function deelaration 

jmpji)uf myjenvironment; 

. . . code . . . 
If (setjmp (my^nvironment)?^) { 

thitt is the co4t afltr the return fro m langjmp 
. . . more code . . . . 

register variables h4tve unpredictable values 
. . more code . . . . 
} else ( 

this is tht return from^ setjmp 
. . . more code . . . 
Do ri(r^ moi£(f](f register variables 
in this leg of the coM 
. . . more code .... 

) 

Setjmp and longjmp save and restore the signal mask sig8etmask{2)i while _setjmp and' _longjmp 
manipulate only the C stack and registers. 
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SEE ALSO 

sigsetmask(2), sigvec(2), signal(3) 

BUGS 

Setjmp does not save current notion of whether the process is executing on the signal stack. The 
result is that a longjmp to some place on the signal stack leaves the signal stack state incorrect. 
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NAME 

setuid, seteuid, setruid, setgid, setegid, setrgid - set user and group ID 

SYNOPSIS 

«etuld(uid) 

8eteuid(euld} 

fietruid(rttld) 

setgld(gid) 

8etegld(e|^d) 

eetrgid(rgld) 

DESORIPTION 

Setuid {etigid) sets both the real and effective user iD^i^oup ID) ot the current process to as 
specified. 

Seieuid (setegid) sets tlie effective user ID (group ID) of the current process. 

Setruid {setruid) sets the real user ID (group ID) of the current process. 

These cdls are only permitted to the super-user or if the argument is the real or effective H). 

SEE ALSO 

8etreuid(2), 8etregid(2), getuid(2), getgid(2) 

DIAGNOSTICS 

Zero is returned if the user (group) ID is set; -1 is returned otherwise, with the global variable 
errno set as for setxeuid or setregid. 
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NAME 

signal - simplifled software signal facilities 

SYNOPSIS 

#inelude <iign&l.h> 

(*8ignal(8ig, tunc))0 
void (*func)Ol 

DESCRIPTION 

Signal is a simplified interface to the more general 9igvec{2) facility. 

A signal is generated by some abnormal event, initiated by a user at a terminal (quit, interrupt, 
stop), by a program error (bus error, etc.), by request of another program (kill), or when a process 
is stopped because it wishes to access its control terminal while in the background (see tty{4)). 
Signals are optionally generated when a process resumes after being stopped, when the status of 
child processes changes, or when input is ready at the control terminal. Most signals cause termi- 
nation of the receiving process if no action is taken; some signals instead cause the process receiv- 
ing them to be stopped, or are simply discarded if the process has not requested otherwise. 
Except for the SIGKUiL and SIGSTOP signals, the eignai call allows signab either to be ignored 
or to cause an interrupt to a specified location. The following is a list of all signals with names as 
in the include file <»tirna/.A>: 

hangup 

interrupt 

quit 

illegal instruction 

trace trap 

lOT instruction 

EMT instruction 

floating point exception 

kill (cannot be caught or ignored) 

bus error 

segmentation violation 

bad argument to system call 

write on a pipe with no one to read it 

alarm clock 

software termination signal 

urgent condition present on socket 

stop (cannot be caught or ignored) 

stop signal genera,ted from keyboard 

continue after stop 

child status has changed 

background read attempted from control terminal 

background write attempted to control terminal 

i/o is possible on a descriptor (see fcntl{2)) 

cpu time limit exceeded (see 8etrHmit{2)) 

file size limit exceeded (see 8etrlimU{2)) 

virtual time alarm (see ietitimer{2)) 

profiling timer alarm (see 8eHHmer{2)) 

window changed 

The starred signals in the list above cause a core image if not caught or ignored. 

It fune is SIGJDFL, the default action for signal eig is reinstated; this default is termination (with 
a core image for starred signals) except for signals marked with • or f. Signals marked with • are 
discarded if the action is SIG_DFL; signals marked with t cause the process to stop. If func is 
SIG_IGN the signal is subsequently ignored and pending instances of the signal are discarded. 



SIGHUP 


1 


SIGINT 


2 


SIGQUIT 


3* 


SIGILL 


4* 


SIGTRAP 


5* 


SIGIOT 


6* 


SIGEMT 


7* 


SIGFPE 


8* 


SIGKILL 





SIGBUS 


10* 


SIGSEGV 


11* 


SIGSYS 


12* 


SIGPIPE 


13 


SIGALRM 


14 


SIGTERM 


15 


SIGURG 


16 


SIGSTOP 


17t 


SIGTSTP 


18t 


SIGCONT 


l^k 


SIGCHLD 


20« 


SIGTTIN 


21t 


SIGTTOU 


22t 


SIGIO f 


23 


SIGXCPb 


24 


SIGXFS2 


25 


SIGVTALRM 26 


SIGPROF 


27 


SIGWINCH 


28 



62 
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Otherwise, when the signal occurs further occurences of the signal are automatically blocked and 
func is called. 

A return from the function unblocks the handled signal and continues the process at the point it 
was interrupted. Unlike previous signal facilities, the handler func remains installed after 
a sisnal has been delivered. 

If a caught signal occurs during certain system calls, causing the call to terminate prematurely, 
the call is automatically restarted. In particular this can occur during a read or wriU{2) on a slow 
device (such as a terminal; but not a file) and during a wait[2). 

The value of signal is the previous (or initial) value of func for the particular signal. 

After a fork{2) ot vfork{2) the child inherits all signals. An exuve[2) resets all caught signals to 
the default action; ignored signals remain ignored. 

RETURN VALUE 

The previous action is returned on a successful call. Otherwise, -1 is returned and errno is set to 
indicate the error. 

ERRORS 

5|^»a/ will fail and no action will take place if one of the following occur: 

|EINVAL| Sig SBnoi a valid signal number. 

|EINVAL| An attempt is made to ignore or supply a handler for SIGKILL or SIGSTOP. 

[EINVALl An attempt is made to ignore SIGCONT (by default SIGeONT is ignored). 

SEEALSO 

kill(l), ptrace(2), kill(2), sigvec(2), 8igbIock(2), 8igsetmask(2), sigpause(2), sigstack(2), setjmp(3), 
tty(4) 

NOISES (VAX-11) 

The handler routine can be declared: 

handler(8ig, code, scp) 

Here 9%g is the signal number, into which the hardware faults and traps are mapped as defined 
below. Code is a parameter which is either a constant as given below or, for compatibility mode 
faults, the code provided by the hardware. 5cp is a pointer to the atruct aigconttxt yat&hy the 
system to restore the process context from before the signal. Compatibility mode faults are di»« 
tinguished from the other SIGILL traps by having PSL.CM set in the psl. 

The following defines the mapping of hardware traps to signals and codes. AH of these symbols 
are defined in <»tVna/./i>: 

Hardware condition Signal Code 



Arithmetic traps: 

Integer overfiow SIGFPB 

Integer division by zero SIGFPE 

Floating overflow trap SIGFPE 
Floating/decimal division by zero SIGFPE 

Floating underflow trap SIGFPE 

Decimal overflow trap SIGFPE 

Subscript-range SIGFPE 

Floating overflow fault SIGFPE 

Floating divide by zero fault SIGFPE 

Floating underflow fault SIGFPE 

Length access control SIGSEGV 

Protection violation SIGBUS 

Reserved instruction SIGILL 



FPEJNTOVF^TRAP 

FPEJNTDIV_TRAP 

FPE^FLTOVF^TRAP 

FPE^FLTDIV.TRAP 

FPE_FLTUND_TRAP 

FPE_DECOVF_TRAP 

FPE_SUBRNG_TRAP 

FPE_FLTOVF_FAULT 

FPE_FLTDIV^FAULT 

FPE_FLTUND FAULT 



ILL_RESAD FAULT 
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.(3) 


SUBROUTINES 


Custodicr-reserved instr. 


SIGEMT 




Reserved operand 


SIGILL 


ILL_PRIVIN_FAULT 


Reserved addressing 


SIGILL 


ILL.RESOP.FAULT 


Trace pending 


SIGTRAP 




Bpt instruction 


SIGTRAP 




Compatibility-mode 


SIGILL 


hardware supplied cod( 


Chme 


SIGSEGV 




Chms 


SIGSEGV 




Chmu 


SIGSEGV 





SIGNAL (3) 
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NAME 

sleep - suipend execution for interval 

SYNOPSIS 

■t«ep(t«eondB) 
uniigncd ••eondti 

DESCRIPTION 

Sleep suspends the current process from execution for the number of seconds specified by the 
argument. The actual suspension time may be up to 1 second less than that requested, because 
scheduled wakeups occur at fixed 1-second intervals, and may be an arbitrary amount longer 
because of other activity in the system. 

Sleep is implemented by setting an interval timer and pausing until it expires. The previous state 
of this timer is saved and restored. If the sleep time exceeds the time to the expiration of the 
previous value of the timer, the process sleeps only until the timer would have expired, and the 
signal which occurs with the expiration of the timer is sent one second later. 

SEE ALSO 

setitimer(2), sigpause(2) 

BUGS 

An interface with finer resolution is needed. 
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NAME 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, index, rindex - string operations 

SYNOPSIS 

#inelude <Btring8.h> 

char *strcat(8l, e2) 
char *•!, *82| 

char *strneat(sl, »%, n) 
char *■!, *s2| 

8trcmp(il» 12) 
char *sl, *s2) 

■trncmp(ii» s2y n) 
char *sl, *s2| 

char *Btrcpy(sl, 12) 
char *bI, "'■2; 

char *strncpy(il, 12, n) 
char *•!, *b2| 

■trlen(i) 
char *•! 

char *index(s, c) 
char *■, c| 

char *rlndex(Sf c) 
char *i, cf 

DESCRIPTION 

These functions operate on null-terminated strings. They do nol check for overflow of any receiv- 
ing string. 

Strcat appends a copy of string 92 to the end of string $1. Strncat copies at most n characters. 
Both return a pointer to the null-terminated result. 

Strcmp compares its arguments and returns an integer greater than, equal to, or less than 0, 
according as tl is lexicographically greater than, equal to, or less than tS. Strncmp makes the 
same comparison but looks at at most n characters. 

Strcpy copies string sS to $1, stopping after the null character has been moved. Strncpy copies 
exactly n characters, truncating or null-padding 92; the target may not be null-terminated if the 
length ot 92 ia n or more. Both return 9l. 

Strlen returns the number of non-null characters in «. 

Index (rindex) returns a pointer to the first (last) occurrence of character c in string 9, or zero if e 
does not occur in the string. 



BUGS 



Strcmp uses native character comparison, which is signed on the Sun. 

On the Sun processor (and on some other machines), you can NOT use a zero pointer to indicate 
a null string. A zero pointer is an error and results in an abort of the program. If you wish to 
indicate a null string, you must have a pointer that points to an explicit null string. On PDP-ll's 
and VAX'en, a source pointer of zero (0) can generally be used to indicate a null string. Program- 
mers using NULL to represent an empty string should be aware of this portability issue. 
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NAME 

swab - swap bytes 

SYNOPSIS 

■wab(from9 to, nbytes) 
chmr *IVom, *to| 

DESCRIPTION 

Swab copies nbytea bytes pointed to by from to the position pointed to by to, exchanging adjacent 
even and odd bytes. It is useful for carrying binary data between high-ender machines (IBM 
360*8, MCeSOOO's, etc) and low<^nder machines (PDP-11 's and VAX'es). 

Nbyte8 should be even, 

The from and to addresses should not overlap in portable programs. 
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NAME 

syslog, openlog, closelog - control system log. 

SYNOPSIS 

#include <sy8log.h> 

openlog(ident, logitat) 
char *ident; 

■ysIog(prlority, mestagey parameters ..» ) 
char "'mesiagei 

closelogO 

DESCRIPTION 

Syglog arranges to write the meeaage onto the system log maintained by 8i/8hg{S). The message is 
tagged with priority. The message looks like a printf{3S) string except that %in is replaced by 
the current error message (collected from errno). A trailing newline is added if needed. This 
message will be read by 8y8log{S) and output to the system console or files as appropriate. 

If special processing is needed, openlog can be called to initialize the log file. Parameters are ident 
which is prepended to every message, and hg8tat which is a bit field indicating special status; 
current values are: 

LOG_PID log the process id with each message: useful for identifying instantiations of dae- 
mons. 

Openlog returns zero on success. If syslog cannot send datagrams to 8y8log{S), then it writes on 
I devj console instead. If fdev/ console cannot be written, standard error is used. In either case, it 
returns -1. 

Closelog can be used to close the log file. It is automatically closed on a successful exec system 
call (see execve{2)). 

EXAMPLES 

sy8log(LOG_SALERT, "who: internal error 23"); 

openlog("serverftp'', LOG_PID); 

8y8log(LOGJNFO, "Connection from host %d", CallingHost); 

SEE ALSO 

sy8log(8) 
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NAME 

system - issue a shell command 

SYNOPSIS 

lyBtem(strlng) 
char "'■trhisi 

DESCRIPTION 

System causes the etring to be given to 8h{l) as input as if the string had been typed as a com- 
mand at a terminal. The current process waits until the shell has completed, then returns the 
exit status of the shell. 

SEE ALSO 

popen(3S), execve(2), wait(2) 

DIAGNOSTICS 

Exit status 127 indicates the shell couldn't be executed. 
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NAME 

ttyname, isatty, ttyslot - find name of a terminal 

SYNOPSIS 

char *ttynaine(flledes) 

Isatty(flledes) 

ttyslotO 

DESCRIPTION 

Ttyname returns a pointer to the null-terminated path name of the terminal device associated 
with file descriptor filedes. 

Isatty returns 1 if fUedes is associated with a terminal device, otherwise. 

Ttyslot returns the number of the entry in the ttya{h) file for the control terminal of the current 
process. 

FILES 

/dev/* 
/etc/ttys 

SEE ALSO 

ioctl(2), ttys(5) 

DIAGNOSTICS 

Ttyname returns a null pointer (0) if fUedet does not describe a terminal device in directory 
'/dev'. 

Ttyslot returns if '/etc/ttys' is inaccessible or if it cannot determine the control terminal. 

BUGS 

The return value pmnts to static data whose content fs overwritten by each call. 
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NAME 

v&!lc^ - aligned memory allocator 

SYNOPSIS 

ch&r *valloe(8lse) 
isnsigiied sisei 

PESGRIPTION 

Valloe allocates size bytes aligned on a page boundary. It is implemented by cadling malloc{3) 
with a slightly larger request, saving the true beginning of the block allocated, and returning a 
properly aligffied pointer. 

DIAQNOSTICS 

Valloe returns a null pointer (0) if there is no available memory or if the arena has been detect- 
ably corrupted by storing outside the bounds of a block. 

SUGS 

Vfree iza*t implemented. 
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NAME 

varargs - variable argument Ibt 

SYNOPSIS 

#include <varargf.h> 

/u n c^t on(va_aUst ) 

v«_dcl 

va_llit pvar; 

vajitart(pt;ar); 

f -• vaj»rg(pt;ar, type); 

vajend(pt;ar); 

DESCRIPTION 

This set of macros provides a means of writing portable procedures that accept variable argument 
lists. Routines having variable argument lists (such as printJ{SS)) that do not use varargs are 
inherently nonportable, since different machines use different argument passing conventions. 

va_aUat is used in a function header to declare a Variable argument list. 

vajdel is a declaration for vajallst. Note that there is no semicolon after vajdcL 

va.Uat IB a type which can^ be used for the variable pvar, which is used to traverse the list. One 
such variable must always be declared. 

vajitart(pvar) is called to initialize pvar to the beginning of the list. 

va_arg(pt;or, type) will return the next argument in the list pointed to by pvar. Type is the type 
the argument is expected ta be. Different types can be mixed, but it is up to the routine to know 
what type of atfument is expected, since it caonoTbe detennined at runtime. 

vajBnd(p^uar) is used to fint^ up. 

Multiple traversal, eaclr bracketed by vajitarl^... irajend, are possible. 

EXAMPtiE 

#^ieliide <vara]|(s.h> 

execl(vajaliit) 

va dct 

i 

vaJBiit ajTt 
cfear^le^^ 
elrar*iatgs[IOO{^ 

vas.^tart(ap)? 

file "» vajatg(ap,.«ba9 *]| 

vajeBd(a|r^ >;,_ 

teitsrir eseevf 6le»jtfSB|| 



} 



BITGS^ 



It i» 1^ to the caOing toutine to determme how maar argjumeate there are^ since it is net possible 
to detemiine this froia the stack frame. For example,, execl passes a to signal the end of the 
Uftt. Prir^f cMit telL how nmuty arguments are supposednk^be there bj^ the format. 
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COMPATIBILITY ROUTINES 



INTRO (3C) 



NAM£ 

intro - introduction to compatibility libraiy functions 

DESGRIPTION 

These functions constitute the compatibility library portion of Ubc. They are automatically 
loaded as needed by the compiler cc(l). The link editor searches tbis library under the "-^Ic" 
option. Use of these routines should, (or the most part, be avoided. Manual entries for the func^ 
tions in this libraiy describe the proper rouMne to use. 

LIST OF FUNGTIONS 

Name Appears on Page Description 



alarm 


alarm.3c 


schedule signal after specifled time 


ftime 


time.Sc 


get date and time 


getopt 


getopt.Sc 


get option letter from argv 


gtty 


stty .3c 


set and get terminal state 


nice 


nice.3c 


set program priority 


optstrg 


getopt.3c 


get option letter from argv 


optind 


getopt.3c 


get option letter from argv 


pause 


pause.Sc 


stop until signal 


rand 


rand .3c 


random number generator 


srand 


rand .3c 


random number generator 


stty 


stty .3c 


set and get terminal state 


time 


time.3c 


get date and time 


times 


times.3c 


get process times 


tmpnam 


tmpnam.3c 


create a name for a temporary file 


ulimit 


ulimit.Sc 


get and set user limits 


utime 


utime.3c 


set file times 


vlimit 


vlimit.3c 


control maximum system resource consumption 


vtimes 


vtimes.Sc 


get information about resource Utilization 
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NAME 

alarm - schedule signal after specified time 

SYNOPSIS 

alar in(8econd8) 
unsigned secondsi 

DESCRIPTION 

This interface la obsoleted by ■etitiiner(2). 

Alarm causes signal SIGALRM, see 8igvec{2), to be sent to the invoking process in a number of 
seconds given by the argument. Unless caught or ignored, the signal terminates the process. 

Alarm requests are not stacked; successive calls reset the alarm clock. If the argument is 0, any 
alarm request is canceled. Because of scheduling delays, resumption of execution of when the sig> 
nal is caught may be delayed an arbitrary amount. The longest specifiable delay time is 
2147483647 seconds. 

The return value is the amount of time previously remaining in the alarm clock. 

SEE ALSO 

sigpau8e(2), 8igvec(2)^, signal(3)^ 8leep(3) 
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NAME 

getopt, optarg, optind - get option letter from argv 

SYNOPSIS 

Int getopt(arge, ftirgv, optstring) 
tnt args} 
char **apgv| 
char *opt8triiig| 

extern ehar ^optargi 
esctern liat optindi 

DESCRIPTION 

This routine Is Included for compatibility with UNIX system-m. It Is of marginal 
valuet and should not be used In new programs* 

Getopt returns the next option letter in argv that matches a letter in optstring. Optstring is a 
string of recognized option letters; if a letter is followed by a colon, the option is expected to have 
an argument that may or may not be separated from it by white space. Optarg is set to point to 
the start of the option argument on return from getopt. 

Getopt places in optind the argv index of the next argument to be processed. Because optind is 
external, it is normally initialized to zero automatically before the first call to getopt. 

When all optiohs have been processed (i.e., up to the first non-option argument), getopt returns 
EOF« The special option — may be used to delimit the end of the options; EOF will be returned, 
and — will be skipped. 

DIAGNOSTICS 

Getopt prints an error message on stdtfr and returns a question mark (?) when it encounters an 
qption letter not included in op taring. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a command that can 
take the mutually exclusive options a and b> and the options f and o» both of wMch require argu'- 
ments: 

ma!n(argc, argv) 
int argc; 
char **ar^; 

{ 

int c; 

extero int optind; 

extern char *oplarg; 



while ((c =» getopt(arge, argv, "abf:©:")) !«* EOF) 
switch (c) { 
case V: 

if (bflg) 

errflt^ + ; 
etee 

aflg*-!-; 
break; 
case 'b': 

if (a%) 

errfig+ + ; 
else 
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bproc(); 

break; 
case T: 

infile =3 optarg; 

break; 
case 'o': 

ofile a optarg; 

bufsiza a 512; 

break; 
case •?': 

errflg+ + ; 

} 
if (errflg) { 

fprintf(8tderr, "usage: ..."); 
exit(2); 

} 

for (; optind < argc; optind+ + ) { 

if (acces8(argv[optind|» 4)) { 
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NAME 

nice - set program priority 

SYNOPSIS 

niee(lner) 

DESCRIPTION 

Thia laterfae* b obsoleted by ■etprlorlty(2). 

The scheduling priority of the process is augmented by incr. Positive priorities get less service 
than normal. Priority 10 is recommended to users who wish to execute long-running programs 
without flak from the administration. 

Negative increments are ignored except on behalf of the super-user. The priority b limited to the 
range -20 (most urgent) to 20 (least). 

The priority of a process is passed to a child process by /orik(2). For a privileged process to return 
to normal priority from an unknown state, nice should be called successively with arguments -40 
(goes to priority -20 because of truncation), 20 (to get to 0), then (to maintain compatibility 
with previous versions of this call). 

SEE ALSO 

nice(l), getpriority(2), 8etpriority(2), fork(2), renice(8) 
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NAME 

pause - stop until signal 

SYNOPSIS 

pau8e() 

DESCRIPTION 

This fiinction Is obsoleted by tlgpause(2). 

Pause never returns normally. It is used to give up control while waiting for a signal from kiU{2) 
or an interval timer, see eetitimer{2). Upon termination of a signal handler started during a 
pause, the pause call will return. 

RETURN VALUE 

Always returns -1. 

ERRORS 

Pause always returns: 

(EINTR) The call was interrupted. 

SEE ALSO 

kill(2), select(2), 8igpause(2) 
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NAME 

rand, srand - random number generator 

SYNOPSIS 

8pand(seed) 
lot seedi 

rand() 

DESCRIPTION 

Th@ newer r&iidoin(3) should be used In new applications; rand remains for compatl^ 
bilty. 

Rand uses a multiplicative congruential random number generator with period 2^^ to return suc- 
cessive pseudo-random numbers in the range from to 2 -1. 

The generator is reinitialized by calling srand with 1 as argument. It can be set to a random 
starting point by calling Brand -with whatever you like as argument. 

SEE ALSO 

r&ndom(3) 

BUGS 

The low bits of the numbers generated are not very random; use the middle bits. In particular 
the lowest bit is deterministically altematingly ajid 1. 
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NAME 

stty, gtty - set and get terminal state 

SYNOPSIS 

#include <8gtty.h> 

8tty(fd, buf) 

int fd| 

struct sgttyb *buf| 

gtty(fd, buf) 

Intfd; 

struct sgttyb *buf| 

DESCRIPTION 

This Interface Is obsoleted by loctl(3). 

Stty sets the state of the terminal associated with fd. Gtty retrieves the state of the terminal asso- 
ciated with fd. To set the state of a terminal the call must have write permission. 

The stty call is actually "ioctl(fd, TIOCSETP, buf)", while the gtty caU is "ioctl(fd, TIOCGETP, 
buf)". See ioctl{2) and tty{4) for an explanation. 

DIAGNOSTICS 

If the call is successful is returned, otherwise -1 is returned and the global variable errno con- 
tains the reason for the failure. 

SEE ALSO 

ioctl(2), tty(4) 
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NAME 

time, ftime - get date and time 

SYNOPSIS 

tlmeofday <=> tlme(0) 

timeofday ^ tlme(tloc) 
long Hloe; 

#iiiclude <syt/types.h> 
#inelude <syi/tlmeb.h> 
ltime(tp) 
struct timeb Hpi 

DESCRIPTION 

Theie interfacM are obsoleted by gettlmeofday(2). 

Time returns the time since 00:00:00 GMT, Jan. 1, 1970, measured in seconds. 

If Uoe is nonnull, the return value is also stored in the place to which the points. 

The /time entry fills in a structure pointed to by its argument, as defined by <8y8/timeb.h>: 

struct timeb 

{ 

time.t time; 
unsigned short millitm; 
short timezone; 
short dstflag; 

}: 

The structure contains the time since the epoch in seconds, up to 1000 milliseconds of more- 
precise interval, the local time zone (measured in minutes of time westward from Greenwich), and 
a flag that, if nonzero, indicates that Daylight Saving time applies locally during the appropriate 
part of the year. 

SEE ALSO 

date(l), gettimeofday(2), settimeofday(2), ctime(3) 
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NAME 

times - get process times 

SYNOPSIS 

#include <8ys/types.h> 
#include <iy8/tlmei.h> 

times(buffer) 
struct tm« ^buffer} 

DESCRIPTION 

This interface is obsoleted by getruBage(3). 

Times returns time-accounting information for the current process and for the terminated child 
processes of the current process. All times are in 1/HZ seconds, where HZ is 60. 

This is the structure returned by timet: 

struct tms { 

time_t tms_utime; /* user time */ 

time_t tmsjBtime; /* system time */ 

time_t tmsjcutime; /* user time, children */ 

time.t tms.cstime; /* system time, children */ 
/» 
The children times are the sum of the children's process times and their children's times. 

SEE ALSO 

ttme(l), getru8age(2), wait3(2), time(3C) 
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NAME 

tmpnam - create a aame for a temporary file 

SYNOPSIS 

#lnclud« <8tdio^!i > 

char *tmpn«m(i) 
chftr *•) 

DESCRIPTION 

Thli routine b Included for ■ystem-III compatibility. 

Tmpnam generates a file name that can safely be used for a temprary file. If (int)9 is zero, 
tmpnam leaves its result in an internal static area and returns a pointer to that area. The next 
call to tmpnam will destroy the contents of the area. If (int)9 is nonzero, 8 is assumed to be the 
address of an array of at least L_tmpnam bytes; tmpnam places its result in that array and 
returns « as its value. 

Tmpnam generates a different file name each time it is called. 

Files created using tmpn&m and either /open or creat are only temporary in the sense that they 
reside in a directory intended for temporary use, and their names are unique. It is the user's 
responsibility to use unlink{2) to remove the file when its use is ended. 

SEE ALSO 

crcat(2), unlink(2), mktemp(3), fopen(3S) 

BUGS 

If called more than 17,576 times in a single process, Impnam will start recycling previously used 
names. 

Between the time a file name is created and the file is opened, it is possible for some other process 
to create a file with the same name. This can never happen if that other process is using tmpnam 
or mktemp, and the file names are chosen so as to render duplication by other means unlikely. 
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NAME 

ulimit - get and set user limits 

SYNOPSIS 

long ulimit (cmd, aewUmit) 
int cmdj 

DESCRIPTION 

Thii function it ineluded for •yst«m-III compatibility, and Is obsoleted by $etrtimU{2). 

This function provides for control over process limits. The emd values available are: 

t Get the process's file size limit. The limit is in units of 512-byte blocks and is inherited 

by child processes. Files of any size can be read. 

2 Set the process's file size limit to the value of newlimit. Any process may decrease this 

limit, but only a process with an effective user ID of super-user may increase the limit. 
Ulimit will fail and the limit will be unchanged if a process with an effective user ID other 
than the super-user attempts to increase its file size limit. 

8 Get the maximum possible break value. See brk{2). 

RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise a value of -1 is returned 
and errno is set to indicate the error. 

SEE ALSO 

brk(2), setrlimit(2), write(2) 
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NAME 

utime - set file times 

SYNOPSIS 

#lnelude <8ys/typet.h> 

utime(flley timep) 

timejfe timep [2]| 

DESCEIPTIGN 

This Interface is obsoleted by utimes(2). 

The utime call uses the 'accessed* and 'updated' times in that order from the timep vector to set 
the corresponding recorded times for file. 

The caller must be the owner of the file or the super-user. The 'tnode^chsmged' time of the file is 
set to the current time. 

SEE ALSO 

utime8(2), 8tat(2) 
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NAME 

vUrait - control maKimum system resource consumption 

SYNOPSIS 

#iDclude <syB/vUmit.h> 

vUmit(re80urce, value) 

DESCRIPTION 

This facility b tuperieded by getrllnilt(S). 

Limits the consumption by the current process and each process it creates to not individually 
exceed value on the specified resource. If vatue is specified as -1, then the current limit is returned 
and the limit is unchanged. The-resources which are currently controllable are: 

LIM.NORAISB 

A pseudo-limit; if set aon--zero then the Hmits may not be raised. Only the 
Buper*user may remove the noraiat restriction. 

LIM_CPU the maximum number of cpt^econds to be used 1^ each process 

LIM JPSIZC^ the largest sin^ file whicb can be created^ 

LpiiU>ATA the maetimum growth of the dat»f* stack region viar abfk{2) beyond the end of 
the program'text 

I»IKI_STACK the maximum site of the automatkatfy«extended stack region 

LIM_CORE^ the site of the largest core dump that will be cteated. 

LIM_MAXRS£U 

a soft limit for the amount of ph3r8ical memory (In bytes^^to be given ta the pro- 
gram, if memory is tight, the system will prefer to take memory fr<Hn processes 
which are exceeding their declared LIM.MAXRSIS. 

Because this information is stored in the per-process inf(»mation this system call must be exe- 
cuted directly by the shell if it is to affect all future processes created by the shelly limit is thus a 
built-in command to cff/^(l). 

The system refuses to extend the data or stack space ^i^n the limita would be exceeded in the 
normal way; a break call fails if the data space Knit is reached, or the process is killed when the 
stack limit is reached (since the stack cannot be extended, there is no way to send a signall). 

A file i/o operation iK^ick would create a file which is too large will cause a signal SIQXFSZ to be 
generated, this normally terminates the process, but may be caught. When the cpu time limit is 
exceeded,- a signal SIOXCPU is sent to the offending proces^ta a^w it tfme to process the sH(nal 
it \a given & seconds grace by rattsing the cpu time limit. 

SEE ALSO 

csh(l|L 

BUGS 

It LQif_NCHlAl£^ is set, then no grace should be gsven wli«t the cpu time lunit is exceeded.^ 

There should be Hmit and nnlimit commands in tikfl) as weK as io eah^ 
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NAME 

vtimes - get informatioii about resource utilization 

SYNOPSIS 

vtlmes(parjvin, chjvm) 

struct vtimet *par_vmi *ch_vm> 

DESCEIPTION 

This facility b supers^ed by getru8age(2). 

Vtimei returns accounting information for the current process and for the terminated child 
processes of the current process. Either parjum or chjum or both may be 0, in which case only 
the information for the pointers which are non-zero is returned. 

After the call, each buffer contains information as defined by the contents of the include file 
<8y8lvtime8.h>: 

struct vtimes { 

int vmjutime; /* liser time (*HZ) */ 

int vm_8time; /* system time (*HZ)*/ 
/* divide next two by utime-h stime to get averages */ 

unsigned vmjidsrss; /* integral of d+s rss */ 

unsigned vmjxrss; /* integral of text rss */ 

int vm.maxrss; /* maximum rss */ 

int vmjmajfit; /* major page faults */ 

int vm^minfit; /* minor page faults */ 

int vmjiBwap; /♦ number of swaps */ 

int vmjnblk; /♦block reads*/ 

int vmjoublk; /♦block writes */ 

}; 

Th® vmjutime and vmjBtime fields give the user and system time respectively in 60ths of a second 
(or SOths if that is the frequency of wall current in your locality.) The vmjidrsB and vm_ixr«9 
measure memory usage. They are computed by integrating the number of memory pages in use 
each over cpu time. They are reported as though computed discretely, adding the current 
memory usage (in 512 byte pages) each time the clock ticks. If a process used 5 core pages over 1 
cpu-seeond fo^ its data and stack, then vmjidsrea would have the value 5*60, where 
vrnjutime-t- vmjstime would be the 60. Vm^idsree integrates data and stack segment usage, while 
vm^isras integrates text segment usage. Vm^maxret reports the maximum instantaneous sum of 
the text4- data+ stack core-resident page count. 

The vmjmajJU field gives the number of page faults which resulted in disk activity; the vm_minJU 
field gives the number of page faults incurred in simulation of reference bits; vm_n9wap is the 
number of swaps which occurred. The number of file system input/output events are reported in 
vm^inbik Bud vni^oublk These numbers account only for real i/o; data supplied by the caching 
mechanism is charged only to the first proce^ to read or write the data. 

SEE; ALSO ,,/ 

getrusage(2), walt3(2) 
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NAME 

ictro - introduction to mathematical library functions 

DESCRIPTION 

These functions constitute the math library, Hbm. They are automatically loaded as needed by 
the Fortran compiler /77(1). The link editor searches this library under the "-Im" option. 
Declarations for these functions may be obtained from the include file <math.h>. 

LIST OF FUNCTIONS 

Name Appears on Page DeseripHon 

trigonometric functions 

trigonometric functions 

trigonometric functions 

trigonometric functions 

Euclidean distance 

absolute value, floor, ceiling functions 

trigonometric functions 

hyperbolic functions 

exponential, logarithm, power, square root 

absolute value, floor, ceiling functions 

absolute value, floor, ceiling functions 

log gamma function 

Euclidean distance 

bessel functions 

bessel functions 

bessel functHms 

exponential, logarithm, power, square root 

exponential, logarithm, power, square root 

exponential, logarithm, power, square root 

trigonometric functions 

hyperbolic functions 

exponential, logarithm, power, square root 

trigonometric functions 

hyperbolic functions 

bessel functions 

bessel functions 

bessel functions 



aeos 


sin .3m 


asin 


sin. 3m 


atas 


sin .3m 


ataE2 


sin .3m 


cabs 


hypot.3m 


ceil 


fioor.3m 


cos 


sin .3m 


cosh 


sinh. 3m 


exp 


exp.Sm 


fabs 


fLooT.Zm 


floor 


floof;3m 


gamma 


gamma.3m 


hypot 


hypot.3m 


JO 


J0.3m 


|l 


j0.3m 


Js 


j0.3m 


log 


exp.3m 


logics 


exp.Sm 


pow 


exp.3m 


sin 


sin.3m 


sinh 


sinh.3m 


sqrfe 


exp.Sm 


tan 


sin.3!n 


tanb 


sinh.Sm 


yO 


j0.3m 


yi 


jO-Sm 


yn 


j0.3m 
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NAME 

exp, log, loglO, pow, sqrt - exponential, logarithm, power, square root 

SYNOPSIS 

#liiclude <math.h> 

double exp(x) 
double X} 

double log(x) 
double x| 

double loglQ(x) 
double x| 

double pow(x, y) 
double x, yi 

double 8qrt(x) 
double xy 

DESCRIPTION 

Exp retwns the exponential function of z. 

Lap^ returns the natural logarithm of z; togtCftetmna the base 10 logarithm. 

Pow returns x*. 

Sqrt returns the square root of x. 

SEE ALSO 

hypot(3M), sinh(3M), intro(2) 

DIAGNOSTICS 

Exp and pow return a huge value when the correct value would overflow; errno is set to 
ERANGE. Pow returns and sets errno to EDOM when the^ second argument is negative and 
non-integral and when both arguments are 0. 

Log returns when z is zero or negative;^ errno is set to E3>OM. 

Sqrt returns when z is negative; errno is set to EDOM. 
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NAME 

fabs, floor, ceil - absolute value, floor, ceiling functions 

SYNOPSIS 

#include <math.h> 

double floor(x) 
double X) 

double e^(x) 
double x| 

double fabs(x) 
double x; 

DESOEIPTION 

Fab» returns the absolute value | x |. 

Floor returns the largest integer not greater tb^ x. 

Ceii returns the sniaUest integer not less than x. 

Sm ALSO 



BUOS 

The fabs function is actually in the standard library, and should be moved to the math library. 
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NAME 

gamma - log gamma function 

SYNOPSIS 

#inelude <math.h> 

double gamma(x) 
double x; 

DESCRIPTION 

Gamma returns In |^r(|z|)|. The sign of r(|^^j^)^ is returned in tbe external integer ngngam. 
The following C program might be used to calculate F: 

y « gamma(x); 
^fdef vax 

if(r>8».0) 
#endif 
#ifdef sun 

if(y> 706.0) 
#eirdir 

error(); 

y =- cxp(y); 

if(8igngam) 

y — -y;^ 

DIAGNOSTICS 

A huge value is returned for negative integer arguments. 

BUGS 

There should be a positive indication of error. 
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NAME 

hypot, cabs -- Euclidean dbtance 

SYNOPSIS 

#lnelud« <math.h> 

double hypot(x, y) 
double Xf yi 

double eabs(s) 

•truet { double X, yi) i| 

DESCRIPTION 

Hypot and cabs return 

8qrt(x*x + y*y), 
taking precautions against unwarranted overflows. 

SEE ALSO 

exp(3M) for gqrt 
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NAME 

JO^ jl» jn» yO, yl, yn - bcsscl functions 

SYNOPSIS 

^Include <m«thJik> 

doable JO(x) 
double x| 

^ublejl(x) 
double X) 

double Jn(ii, x) 
double x| 

double yO(x) 
double x| 

double yl(x) 
double x| 

double yn^r x) 
double x| 

DESCRIPTION 

These functions calculate Bessel functions of the first and second kinds for real arguments and 
integer orders. 

DIAGNOSTICS 

Negative arguments cause yO, yl, and yn to return a huge negative value and set trrno to EDOM. 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions 

SYNOPSIS 

#imelud8 <math.h> 

double sln(x) 
double x| 

double eo8(x) 
double XI 

double a8ln(3c) 
double x| 

double aeo8(x) 
double x| 

double at&ra(x) 
double x| 

double &t&nS(Xf y) 
double Xg sr| 

DESCRIPTION 

Sin, COS and tan return trigonometric functions of radian arguments. The magnitude of the argu- 
ment should be checked by the caller to make sure the result is meaningful. 

Asin returns the arc sin in the range -n/2 to n'/2. 

Acos returns the arc cosine in the range to n. 

Atan returns the are tangent of x in the range -7r/2 to ir/2. 

AtanS returns the arc tangent of x/y in the range -n to ir. 

DIAGNOSTICS 

Arguments of magnitude greater than 1 cause asin and acoa to return value 0; errno is set to 
EDOM. The value of tan at its singular points is a huge number, and errno is set to ERANGE. 

Tha value of tan for arguments greater than about 2**31 is garbage. 
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NAME 

sinh, cosh, tanh - hyperbolic functions 

SYNOPSIS 

#include <math.h> 

douMe 8inh(x) 

double eo8h(x) 
double x; 

double tanh(x) 
double x;^ 

DESCRIPTION 

These (uncti<His compute the designated hyperbolic functions for real arguments. 

DIAGNOSTICS 

Sink and eosk return a huge value ofappropriate sign when the correct value would overflow. 
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NAME 

intro - introduction to network library functions 

DESCRIPTION 

This section describes functions that are applicable to the DARPA Internet; network, which are 
part of the standard C library. 

LIST OF FUNCTIONS 

Name • 



endhostent 

endnetent 

endprotoent 

endservent 

gethostbyaddr 

gethostbyname 

gethostent 

getnetbyaddr 

getnetbyname 

getnetent 

getprotobyname 

getprotoby number 

getprotoent 

getservbyname 

getservbyport 

getservent 

htonl 

htons 

inet.addr 

inetjlnaof 

inet_makeaddr 

inet_netof 

inetjnetwork 

inetjDtoa 

ntohl 

ntohs 

rcmd 

rexec 

rresvport 

ruserok 

sethosteni 

setnetent 

setprotoent 

setservent 



Appears on Page 

getho8tent.3n 

getnetent.Sn 

getprotoent.Sn 

getservent.Sn 

gethostent.Sn 

gethostent.Sn 

gethostent.Sn 

getnetent.Sn 

getnetent.Sn 

getnetent.Sn 

getprotoent.Sn 

getprotoent.Sn 

getprotoent.Sn 

getservent.Sn 

getservent.Sn 

getservent.Sn 

byteorder.Sn 

byteorder.Sn 

inet.Sn 

inet.Sn 

inet.Sn 

inet.Sn 

inet.Sn 

inet.Sn 

byteorder.Sn 

byteorder.Sn 

rcmd.Sn 

rexec.Sn 

rcmd.Sn 

rcmd.3n 

gethostent.Sn 

getnetent.Sn 

getprotoent.Sn 

getservent.Sn 



Description 

get network host entry 

get network entry 

get protocol entry 

get service entry 

get network host entry 

get network host entiy 

get network host entry 

get network entry 

get network entry 

get network entry 

get protocol entry 

get protocol entry 

get protocol entry 

get service entry 

get service entry 

get service entry 

convert values between host and network byte order 

convert values between host and network byte order 

Internet address manipulation 

Internet address manipulation 

Internet address manipulation 

Internet address manipulation 

Internet address manipulation 

Internet address manipulation 

convert values between host and network byte order 

convert values between host and network byte order 

routines for returning a stream to a remote command 

return stream to a remote command 

routines for returning a stream to a remote command 

routines for returning a stream to a remote command 

get network host entry 

get network entry 

get protocol entry 

get service entry 
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NAME 

htonl, htons, ntohl, atohs - convert values between host and network byte order 

SYNOPSIS 

#lnclude <sy8/typeB.h> 
#liiclude <netliiet/faiai> 

netlong ss htojil(hoBtloiig)r 
ujking neilongy hosttong) 

nsishort ^ htons(host8hoct)| 
ujihort netshortt hostshortf 

hoitlong =s ntohl(ne^ng)t 
itjeng hostlongi^i&etloBgr 

Ikostabori ss iitohs(ii«tBliort)| 
i^sfaort bostihortr nabiborti 

DESCRffTKW 

Tbe8» routines convert 10 and 32 bit quantities between^networic l^te order and host byte order. 
On machines such aa the Sun these routines ar« defined asr null macrot b the mclude file 

<netme(/m.ft>. 

These routines are most often used in conjunction with Internet addresses and ports sa returned 
by tetho9tent{3>N)tndget9ervent{SN), 

SE&ALSO 

getho8tent(3N)^ getservent(3N) 

Biras 

The VAX bandies bytes backwards from most everyone ebe in the world. This irnot expected to 
be fixed ui the near future. 
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NAME 

gethoitent, gethostbyaddr, gethostbyname, sethostent, endhostent - get network host entry 

SYNOPSIS 

#include <netdb.h> 

struct hoatent *gethostentO 

struct hostent *getkoitbyname(name) 
char *name| 

■truct hoitent *gethottbyaddr(addr, len, type) 
char *addr} int Iwnt typcf 

■•thoitent(itayop«n) 
Int stayopeB 

•ndhoitentO 

DESCRIPTION 

Oethottent, gethoetbyname, and getkoethyaddr each return a pointer to an object with the follow- 
ing •tnieture containing the brokep-out fieldt of a line in the network host data base, fttcf hosts. 

struct hofitent { 

char *h^name; /* official name of host */ 

char **h_alia8cs; /* alias list */ 

int hjBtddrtype; /* address type */ 

int hjength; /* length of address */ 

char ♦hjiddr; /* address*/ 

); 

The members of this structure are: 

hjsame Official name of tl^ host. 

h^aliases A zero terminated array of alternate names for the host. 

h.addrty pe The type of address being returned; currently always AF_D*^T. 

hjength The length, in bytes, of the address. 

h.addr A pointer to the network address for the host. Host addresses are returned in net- 

work byte order. 

Gethoitent reads the next line of the file, opening the file if necessary. 

Sethoitent opens and reWinds the file. If the ttayopen flag is non-zero, the host data base will not 
be closed after each call to gethootent (either directly, or indirectly through one of the other 
"gethost" calls). 

Endhoetent closes the file. 

Oethoetiyname tLud gethoefbyoddr sequentially search from the beginning of the file until a match- 
ing host name or host address ia found, or until EOF is encountered. Host addresses are supplied 
in network order. 

FILES 

/etc/hosts 

SEE ALSO 

ho6ts(5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 
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BUGS 

All informatioii is contained in a static area so it most be copied if it is to be saved. Only the 
Internet address format is currently understood. 
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NAME 

getiietent, getnetbyaddr, getnetbyname, setnetent, endnetent - get network entry 

SYNOPSIS 

#lnclude <netdb.h> 

struct netent *getnetent() 

struct Ei@t®s&t *getnetbyname(name) 
eh&r *nam®| 

struct netsnt *getnetbyaddr(net, type) 



8®tiiet®iit(8tftyopen) 
lilt stay open 

endnetentQ 

DESGEIPTION 

Getnetent, getnetbyname, and getnetbyaddr each return a pointer to an object witfa the following 
structure containing the broken-out fields of a line in the network dzt^^haae, /etc/ netmorka. 

struct neteini { 

char *n_^ainc; /* olticial name of net^/ 

char **n^alia8es; /* alias list */ 

int n„addrtype; /* net number type */ 

long njiet; /* net number */ 

}; 

The members of this structure are: 

sjBame Th^ official name of the network. 

iB„al!ases A zero terminated list of alternate names for the network. 

ii„a4drty|>e The type of the network number returned; currently only AF_INET. 

n^net The network number. Network numbers are returned in machine byte order. 

Gelrtelerel reads the next line of the file, opening the file if necessary. 

Setnetent opens and rewinds the file. If the Btayopen fiag is non^zero, the net data base will not be 
closed after each call to getnetent {eithet dixectly, or indirectly through one of the other "getnet" 
calls). 

Endnetent closes the file. 

Getnetbyname and getnetbyaddr sequentially search from the beginning of the file until a matching 
net name or net address is found, or until EOF is encountered. Network numbers are supplied in 
host order. 

FILES 

/etc/networks 

SEISALSO 

network8(5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 



BUGS 



All information is contained in a static area so it must be copied if it is to be saved. 
Only Internet network numbers are currently understood. 
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NAME 

getprotoent, getprotobynumber, getprotobyname, setprotoent, endprotoent - get protocol entry 

SYNOPSIS 

#lnclude <netdbJi> 

■tract protoent ^getprotoeiitQ- 

struet protoent *getprotobyiiame(n&me) 
char "'namei 

■truet protoent *getprotobyniimber(proto) 
Int protot 

8etprotoent(8tayopeny 
int stagropen 

endprotoentQ 

DESCRIPTION 

GetpraUent, getpr»tobjfnamef and getprot9bynumher each return a pointer to an object with the 
following structure cMitaining the broken^out fields of a line in the network protocol data base^ 
/ ete^proio cols ^ 

struct protoent ( 

char *p_name? /* offictad name of protocol */ 

char **p_a!iase8^ /* alias fist ♦/" 

loBg p_proto; /* protocol mrniber */ 

}; 

The members of this structure are: 

p_namr The official name of the protocol. 

p_alia8es A zero terminated list of alternate names for the protocol. 

p_proto The protocol number. 

Getprotoent reads the next line of the file, opening the file if necessary. 

Setprotoent opens and rewinds the file. If the staifopen ffag is non-zero, the net data base will not 
be closed after each call to getprotoent (either directly, or indirectly through one of the other 
"getproto" calls). 

Endprotoent closes the file. 

Getprotobyname and getprotobynumber sequentially search from the beginning of the file until a 
matching protocol name or protocol number is found,-or until EOF is encountered. 

FILES 

/etc/protocols 

SEE ALSO 

protocol8(5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 



BUGS 



All information is contained in a static area so it must be copied if it is to be saved. Only the 
Internet protocols are currently understood. 
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NAME 

getsefveDt, getservbyport, getscrvbyname, setservent, endscrvent - get service entry 

SYNOPSIS 

#include <netdb.h> 

struct servent *getBerveiit() 

struct servent *get8ervbyname(namey proto) 
char *iiamef *proto| 

struct servent *get8ervbyport(porty proto) 
int port; char *proto) 

seteervent(8tay open) 
Int stay open 

endserventQ 

DESCRIPTION 

Getstrvent, getscrvbynamt, Bud getservbyport each return a pointer to an object with the following 
structure containing the broken-out fields of a line in the network services data base, 
fete/eervicei. 

struct servent { 

char *sjBame; /♦ official name of service */ 

char **s_alia5cs; /* alias list */ 

long sjiort; /* port service resides at */ 

char *8_protQ; /♦ protocol to use */ 

}; 

The members of this structure are: 

sjii&m® The ofificlal name of the service. 

s^aliases A zero termihated list of alternate names for the service. 

s^OFt The port number at which the service resides. Port numbers are returned in network 
byte order. 

sj>roto The name of the protocol to use when contacting the service. 

Geieervertt reads the next line of the file, opening the file if necessary. 

Seteervent opens and rewinds the file. If the atayopen flag is non-zero, the net data base will not 
be closed after each call to geteervent (either directly, or indirectly through one of the other "get- 
serv" calls). 

End8erver^t closes the file. 

Gettervbyname ^nd getservbyport sequentially search from the beginning of the file until a match- 
ing protocol name or port number is found, or until EOF is encountered. If a protocol name is 
also supplied (non-NULL), seiches must also match the protocol. 

FILES 

/etc/services 

SEE ALSO 

getprotoent(3N), 8ervices(5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

BUGS 

AH information is contained in a static area so it must b« copied if it is to be saved. Expecting 
port numbers to fit in a 32 bit quantity is probably naive. 
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NAME 

inct_addr, met_network, inet.makeaddr, inetjnaof, inetjictof, inetjDtoa - Internet address 

manipulation 

SYNOPSIS 

#include <«ya/soekei.h> 
#lnekrde <net&iet/lnJi> 
#&kclude <arpa/ii&et.b> 

•truet In jaddr 
t]iefejpMfdr(ep][ 
eh&r *cpi^ 

tat 

IiicA^^worfc(ep^ 
dbar *epf 

atruet^ In jaddr 
tneljniakeaddr(net, Ina) 
Int n«t, Inar 

int 

lnetJbaof(in) 
struct In^ddr ln| 

Int 

lnet_netof(in) 
struct Injaddr ln| 

char* 

Inetjatoa(In) 
struct In.addr ln| 

DESCRIPTION 

The routines inttjiddr and inetjnetwork each interpret character strings representing numbers 
expressed in the Internet standard "." notation, returning numbers suitable for use as Internet 
addresses and Internet network numbers, respectively. The routine inetjnakeaddr takes an Inter- 
net network number and a local network address and constructs an Internet address from it. The 
routines inetjnetoj and inttjinaof break apart Internet host addresses, returning the network 
number and local network address part, respectively. 

The routine inetjntoa returns a pointer to a string in the base 256 notation "d.d.d.d" described 
below. 

All Internet address are returned in network order (bytes ordered from left to right). All network 
numbers and local address parts are returned as machine format integer values. 

INTERNET ADDRESSES 

Values specified using the "." notation take one of the following forms: 

a.b.c.d 

a.b.c 

a.b 

a 
When four parts are specified, each is interpreted as a byte of data and assigned, from left to 
right, to the four bytes of an Internet address. Note that when an Internet address b viewed as a 
32-bit integer quantity on the VAX the bytes referred to above appear as "d.c.b.a". That is, 
VAX bytes are ordered from right to left. 

When a three part address is specified, the last part is interpreted as a 16-bit quantity and placed 
in the right most two bytes of the network address. This makes the three part address format 
convenient for specifying Class B network addresses as "128.net.host". 
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When a two part address is supplied, the last part is interpreted as a 24-bit quantity and placed 
in the right most three bytes of the network address. This makes the two part address format 
convenient for specifying Class A network addresses as "net.host". 

When only one part is given, the value is stored directly in the network address without any byte 
rearrangement. 

All numbers supplied as "parts" in a "." notation may be decimal, octal, or hexadecimal, as 
specified in the C language (i.e. a leading Ox or OX implies hexadecimal; otherwise, a leading 
implies octal; otherwise, the number is interpreted as decimal). 

SEE ALSO 

getho8tent(3N), getnetent(3N), hosts(5), networks(5)^ 

DIAGNOSTICS 

The value -1 is returned by inet__addr znd inetjnetwork for malformed requests. 

BUGS 

The problem of host byte ordering versus network byte ordering is confusing. A simple way to 
specify Class C network addresses in a manner similar to that for Class B and Class A is needed. 

The return value from tneLn^oo points to static information which is overwritten in each call. 
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NAME 

rcmd, rresvport, ruserok - routines for returning a stream to a remote command 

SYNOPSIS 

rem = rcmd(aho8t, inport, locuserf remuseTf cmd, fd2p)} 

char ♦*ahoBt; 

ujBhort inport; 

char *locuser, *remuBer, *emd| « 

int *fd2p| 

■ ■■ rr(»vport(port)| 
int *port| 

ru8erok(rho>ty superuier, ruier, luser); 
char *rhost| 
hit tuperuser} 
char *ruMr, "'luseri 

DESCRIPTION 

Rcmd is a routine used by the super-user to execute a command on a remote machine using an 
authentication scheme based on reserved port numbers. Rrtsvport is a routine which returns a 
descriptor to a socket with an address in the privileged port space. Ruserok is a routine used by 
servers to authenticate clients requesting service with rcmd. All three functions are present in the 
same file and are used by the r8hd{^C) server (among others). 

Rcmd looks up the host *ako8t using getho8tbyname{SN), returning -1 if the host does not exist. 
Otherwise *aho8t is set to the standard name of the host and a connection is established to a 
server residing at the well-known Internet port inport. 

If the call succeeds, a socket of type SOCK_STREAM is returned to the caller, and given to the 
remote command as stdhi and stdout. If fd2p is non-zero, then an auxiliary channel to a control 
process will be set up, and a descriptor for it will be placed m "^JiSp. The cc^ntrol process will 
return diagnostic output from the command (unit 2) on this channel, and will also accept bytes on 
this channel as being UNDC signal numbers, to be forwarded to the process group of the com- 
mand. If fd2p is 0, then the stderr (unit 2 of the remote command) will be made the same as the 
stdout and no provision is made for sending arbitrary signals to the remote process, although you 
may be able to get its attention by using out-of-band data. 

The protocol is described in detail in r8hd{^C). 

The rresvport routine is used to obtain a socket with a privileged address bound to it. This 
socket is suitable for use by rcmd and several other routines. Privileged addresses consist of a 
port in the range to 1023. Only the super-user is allowed to bind an address of this sort to a 
socket. 

Ruserok takes a remote host's name, as returned by a getho8terit{ZN) routine, two user names and 
a flag indicating if the local user's name is the super-user. It then checks the files /etc/ hosts. equiv 
and, possibly, shosta in the current working directory (normally the local user's home directory) 
to see if the request for service is allowed. A 1 is returned if the machine name is listed in the 
"hosts.equiv" file, or the host and remote user name are found in the ".rhosts" file; otherwise 
ruserok returns 0. If the superuser fiag is 1, the checking of the "host.equiv" file is bypassed. 

SEE ALSO 

rlogin(lC), rsh(lC), rexec(3N), rexecd(8C), rlogind(8C), rshd(8C) 

BUGS 

There is no way to specify options to the socket call which rcmd makes. 
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NAME 

rexec - return stream to a remote command 

SYNOPSIS 

rem bb rexee(aho8t, Inport, user, pauwd, cmd, fd2p); 

char **«hoit| 

u_^faort inport) 

char *uier, *paMwdf *cmd| 

Int *fdSp| 

DESCRIPTION 

Rexee looks up the host *aho8t using getho8tbyname{SN), returning -1 if the host does not exist. 
Otherwise *aho8t is set to the standard name of the host. If a username and password are both 
specifled, then these are used to authenticate to the foreign host; otherwise the environment and 
then the user's .netre file in his home directory are searched for appropriate information. If all 
this fails, the user is prompted for the information. 

The port inport specifies which well-known DARPA Internet port to use for the connection; it will 
normally be the value returned from the csdl "getservbynameCexec", ''tcp")" (see 
get8ervent{SN)). The protocol for connection is described in detail in rtxecd{SC). 

If the call succeeds, a socket of type SOCK.STREAM is returned to the caller, and given to the 
remote command as ttdin and stdout. If fdSp u non-zero, then a auxiliary channel to a control 
process will be setup, and a descriptor for it will be placed in *fdSp. The control process will 
return diagnostic output from the command (unit 2) on this channel, and will also accept bytes on 
this channel as being UNDC signal numbers, to be forwarded to the process group of the com- 
mand. U fd£p is 0, then the ttd«rr (unit 2 of the remote command) will be made the same as the 
itdout and no provision is made for sending arbitrary signals to the remote process, although you 
may be able to get its attention by using out-of-band data. 

SEE ALSO 

rcmd(3N), rexecd(8C) 

BUGS 

There is no way to specify options to the 80cket call which rexec makes. 
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NAME 

stdio - standard buffered input/output package 

SYNOPSIS 

#lEiclude <Btdlo.h> 

FILE *stdlni 
FILE '^stdouti 
FILE *stderr} 

DESCRIPTION 

The functions described in section 3S constitute a user-level buffering scheme. The in-line macros 
getc and putc{3S) handle characters quickly. The higher level routines gets, fgeta, scanf, facanf, 
/read, pute, /puts, print/, /print/, /write all use getc and pufc; they can be freely intermixed. 

A file with associated buffering is called a stream, and is declared to be a pointer to a defined type 
FILE. A /9pen(3S) creates certain descriptive data for a stream and returns a pointer to desig- 
nate the stream in all further transactions. There are three normally open streams with constant 
pointers declared in the include file and associated with the standard open files: 

stdln standard input file 

atdout standard output file 
stderr standard error file 

A constant 'pointer' NULL (0) designates no stream at alh 

An integer constant EOF (-1) is returned upon end of file or error by integer functions that deal 
with streams. 

Any routine that uses the standard input/output package must include the header file <8tdio.h> 
of pertinent macro definitions. The functions and constants mentioned in sections labeled 3S are 
declared in the include file and need no further declaration. The constants, and the following 
'functions' are implemented as macros; redeclaration of these names is perilous: gttc, getchar, 
pute, putehar, /eo/, /error, fileno, clrerr. 

SEE ALSO 

open(2), close(2), read(2), write(2), freadi(3S), fseek(3S) 

DIAGNOSTICS 

The value EOF is returned uniformly to indicate that a FILE pointer has not been initialized 
with /open, input (output) has been attempted on an output (input) stream, or a FILE pointer 
designates corrupt or otherwise unintelligible FILE data. 

For purposes of efficiency, this implementation of the standard library has been changed to line 
buffer output to a terminal by default and attempts to do this transparently by flushing the out- 
put whenever a read(2) from the standard input is necessary. This is almost always transparent, 
but may cause confusion or malfunctioning of programs which use standard i/o routines but use 
read{2) themselves to read from the standard input. 

In cases where a large amount of computation b done after printing part of a line on an output 
terminal, it is necessary to JB^uah (see /clo8e{ZS)) the standard output before going off and comput- 
ing so that the output will appear. 

BUGS 

The standard buffered functions do not interact well with certain other library and system func- 
tions, especiaJIy v/ork and abort. 

LIST OF FUNCTIONS 

Name Appears on Page Description 

clearerr ferror.Ss stream status inquiries 

fclose fclose.38 close or flush a stream 

fdopen fopen.Ss open a stream 
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feof 


ferror.Ss 


ferror 


ferror.Ss 


fflush 


fcIose.Ss 


fgetc 


getc. 38 


fgets 


gets.Ss 


fileno 


ferror.Ss 


fopen 


fopen.Ss 


fprintf 


printf. 3s 


fputc 


putc.Ss 


fputs 


puts.Ss 


fread 


fread. 3s 


freopen 


fopen. 38 


fscanf 


scanf .3s 


fseek 


fseek.Ss 


ftell 


fseek .3s 


fwritc 


fread. 3s 


getc 


getc. 3s 


getchar 


getc.Ss 


gets 


gets .3s 


getw 


getc.Ss 


pclose 


popen. 3s 


popen 


popen. Ss 


printf 


printf.Ss 


putc 


putc.Ss 


putchar 


putc.Ss 


puts 


puts.Ss 


putw 


putc.Ss 


rewind 


fseek. 3s 


scanf 


scanf .Ss 


setbuf 


setbuf.Ss 


setbuffer 


setbuf.Ss 


setlinebuf 


setbuf.Ss 


sprintf 


printf.Ss 


sscanf 


scanf.Ss 


stdio 


intro.Ss 


ungetc 


ungetc .Ss 
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stream status inquiries 

stream status inquiries 

close or flush a stream 

get character or integer from stream 

get a string from a stream 

stream status inquiries 

open a stream 

formatted output conversion 

put character or word on a stream 

put a string on a stream 

buffered binary input/output 

open a stream 

formatted input conversion 

reposition a stream 

reposition a stream 

buffered binary input/output 

get character or integer from stream 

get character or integer from stream 

get a string from a stream 

get character or integer from stream 

initiate I/O to/from a process 

initiate I/O to/from a process 

formatted output conversion 

put character or word on a stream 

put character or word on a stream 

put a string on a stream 

put character or word on a stream 

reposition a stream 

formatted input conversion 

assign buffering to a stream 

assign buffering to a stream 

assign buffering to a stream 

formatted output conversion 

formatted input conversion 

standard buffered input/output package 

push character back into input stream 
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NAME 

fcloie, Cniush - close or flush a stream 

SYNOPSIS 

#!iielude <Btdlo.h> 

felo@@(str«am) 
FE^E "^stream} 

Mii@li(stre&m) 
FILE '^itreami 

DESCRIPTION 

Fdose causes any buffers for the named stream to be emptied, and the file to be closed. Buffers 
allocated by the standard input/output system are freed. 

Fdoee is performed automatically upon calling exit{3). 

FJlush causes any buffered data for the named output stream to be written to that file. The 
stream remains open. 

SEE ALSO 

close(2), fopen(3S), setbuf(3S) 

DIAGNOSTICS 

The^ routines return EOF if stream is not associated with an output file, or if buffered data can- 

nol b@ transferred to that file. 
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NAME 

ferror, feof, clearerr, fileno - stream status inquiries 

SYNOPSIS 

#inelude <stdlo.h> 

feof(streain) 
FILE *8tream| 

ferror(8tream) 
FILE ^stream 

clearerr(Btream) 
FILE ^stream 

flleno(Btream) 
FILE ^itreami 

DESCRIPTION 

Feo/ returns non-zero when end of file is read on the named inpnt stream, otherwise zero. 

Ferror returns non-zero when an error has occurred reading or writing the named etream, other- 
wise zero. Unless cleared by ciearerr, the error indication lasts until the stream is closed. 

Clrerr resets the error indication on the named stream. 

Fiteno returns the integer file descriptor associated with the stream, see open{2). 

These functions are implemented as macros; they cannot be redeclared. 

SEE ALSO 

fopen(3S), open(2) 
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NAME 

fopen, f reopen, fdopen - open a stream 

SYNOPSIS 

#include <ttdlo.h> 

FILE "f open(filenamey type) 
char ^filename, *type; 

FILE '*fireopen(filename, type, stream) 
char *fllename, *type} 
FILE *streain| 

FILE *fdopen(flldes, type) 
char ""typei 

DESCRIPTION 

Fopen opens the file named by fUename and associates a stream with it. Fop en returns a pointer 
to be used to identify the stream in subsequent operations. 

Type is a character string having one of the following values: 

"r* open for reading 

"w" create for writing 

"a" append: open for writing at end of file, or create for writing 

In addition, each type may be followed by a '+ ' to have the file opened for reading and writing. 
"rH- " positions the stream at the beginning of the file, "w^- " creates or truncates it, and ''a+ " 
petitions it at the end. Both reads and writes may be used on read/write streams, with the limi- 
tation that an /seek, rewind, or reading an end-of-file must be used between a read and a write or 
vice-versa. 

Freopen substitutes the named file in place of the open stream. It returns the original value of 
itream. The original stream is closed. 

Freopen is typically used to attach the preopened constant names, itdin, stdout, stderr, to 
specified files. 

Fdopen associates a stream with a file descriptor obtained from open, dup, creat, or pipe{2). The 
type of the stream must agree with the mode of the open file. 

SEE ALSO 

open(2), fclo8e(3S) 

DIAGNOSTICS 

Fopen and freopen return the pointer NULL if filename cannot be accessed. 

BUGS 

Fdopen is not portable to systems other than UNIX. 

The read/write types do not exist on all systems. Those systems without read/write modes will 
probably treat the type as if the '+ ' was not present. These are unreliable in any event. 



Sun Release 1.1 Last change: 9 June 1981 



FREAD ( 3S ) STANDARD I/O LBRARY FREAD ( 3S ) 



NAME 

fread, fwrite - buffered binary input/output 

SYNOPSIS 

#iiielude <8tdlo.h> 

f^ead(ptr, 8lseof(*ptr), nltemi, stream) 
FILE ^stream; 

fwrlte(ptr, •lzeof(*ptr)9 nltemiy stream) 
FILE ^stream; 

DESCRIPTION 

Fread reads, into a block beginning at ptr, nitemt of data of the type of *ptr from the named 
input atream. It returns the number of items actually read. 

If stream is stdln and the standard output is line buffered, then any partial output line will be 
flushed before any call to read{2) to satisfy the fread. 

Fwrite appends at most nitemf of data of the type of *ptr beginning at ptr to the named output 
ttream. It returns the number of items actually written. 

SEE ALSO 

read(2), write(2), fopen(3S), getc(3S), putc(3S), get8(3S), put8(3S). printf(3S), 8canf(3S) 

DIAGNOSTICS 

Fread and fwrite return upon end of file or error. 
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NAME 

fseek, ftell, rewind - reposition a stream 

SYNOPSIS 

#lnelude <8tdio.h> 

f8eek(8tream, offset, ptrname) 
FILE *stream| 
long offset; 

long ft)ell(8tream) 
FILE "'streami 

rewliid(ttream) 

DESCRIPTION 

Fseek sets the position of the next input or output operation on the stream. The new position is 
at the signed distance offset bytes from the beginning, the current position, or the end of the file, 
according as ptrname has the value 0, 1, or 2. 

Fseek undoes any effects of ungetc{3S). 

Ftell returns the current value of the offset relative to the beginning of the file associated with the 
named stream. It is measured in bytes on UNDC; on some other systems it is a magic cookie, and 
the only foolproof way to obtain an offset for fseek. 

Rewind{stream) is equivalent to f8eek{stream, OL, 0). 

SEE ALSO 

ls€ek(2), fopen(3S) 

DIAGNOSTICS 

Fseek returns -1 for improper seeks. 
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NAME 

getc, getchar, fgetc, getw - get character or integer froip stream 

SYNOPSIS ■* 

#Include <stdio.h> 

Iftt getc(atream) 
FILE "'stream; 

Int geteharQ 

litt ^ete(8tream) 
FILE '"stream; 

Int getw^stream) 
FILE ^stream; 

DESCRIPTION 

Getc retmms tbe next character from the named input etream. 

Getchar{) is tdenticsJ tor ifefc{8tdin). 

Fffttc behaves like gtte^ but is a genuine function, not a macro; it ma^ be used to save object 

Gtfm returns the next CXInt (wend) from the- named input strtam. It returns the constant EOF 
upoft end of file or error^but since that is a good integer value, /eo/and /error(3£K) should be used 
to check the success of gctur^ Getw assumes no special alignment in the file. 

SEE ALSa 

fopen(3S), putc(3S), geta(3S), 8canf(3S), fread(3S), ungetc(3S) 

DIAGNOSTICS 

These functions return the integer constant EOF at end ci file or upon read error. 

A stop with message, 'Reading bad file', means an attempt hati been made to read fibm a stream 
that has not been opened for reading by /0f en. 



BUGS 



The end-of-file return from getchar is incompatible with that ifr UNDC editions 1-6. 

Because it is implemented as a macro, getc treats a etream argument with side effectr incorrectly. 
In p^ticttlar, 'gctc(*r+ + );' doesn't work sensibly. 

Data files written and read with putw and getw are not portable; the size of a» int ud the order 
iaM^tcltdata bytes are stored within an Int varies between^ machines. 
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NAME 

gets, fgets - get a string from a stream 

SYNOPSIS 

#lnclude <stdIo.h> 

char *get8(t) 
char Hi 

char *fget8(8, Df ttream) 

ehar *8| 
FILE *8tream{ 

DESCRIPTION 

Gets reads a string into 8 from the standard input stream stdin. The string is terminated by a 
newline character, which is replaced in 9 by a null character. Ge^; returns its argument. 

Fgeta reads n-1 characters, or up to a newline character, whichever comes first, from the stream 
into the string 9. The last character read into e b followed by a null character. Fj^et^ returns its 
first argument. 

SEE ALSO 

put8(3S), getc(3S), scanf(3S), fread(3S)^ ferror(3S) 

DLIGNOSTIOS 

Gets 2Md fgetsretmn the constant pointer NULL upon end of file or error. 

BUGS 

Ciref 9 deletes a newline, /jpre^t keeps it, all in the name of backward compatibility. 
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NAME 

popen, pclose - initiate I/O to/from a process 

SYNOPSIS 

#lnclude <8tdio.h> 

FILE *popen(command, type) 
char *comm«nd» *type| 

pclose(streain) 
FILE *stre«mt 

DESCRIPTION 

Tbe arguments to pop en are pointers to null-terminated strings^ containing respectively a shell 
command line and an I/O mode, either "r" for reading or "w" for writing. It creates a pipe 
between the calling process and the cononand to be executed. The value reti^rned is a stream 
pcnater that can be used (as appropriate) to write to the standard input of the c<Nnmand or read 
from its standard output. 

A stream opened by pop^en should be closed by pchte, which waits for the associated process to 
terminate and returns the exit status- of the command. 

Because open fifes are shared, a type "r" command maf be used to filter stdtn, and a type "w*^ ta 
fifter stdout. 

SEE ALSO 

prpe(2), fopen(3S), fclose(3S), 8ystem(a),. waie(2), sh(l)- 

DIAGNOSTICS 

Pop en returns a null pdinter if filer or processes eannot be created, or the shell cannot be 
accessed. 

Pctoee returns -1 if stream is not associated with a ^p^ened' command. 

BUGS 

Buffered readmg before opening an input filter may leave t^e standard input of that filter misposi- 
tioned. Similar problems with an output filter ms^ be forestalled by careful buffer fiushing, for 
instance, with fflmh, see fclo8e{3S). 

Popen always calls ak, never calls cahr 
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NAME 

printf, fprintf, sprintf - formatted output conversion 

SYNOPSIS 

#ii&eliici« <etdio.h> 

prlatf^format |, arg | ... ) 

f^rlatf(stre&m9 format (» arg ] ... ) 

FILE ^stfeami 



sprlntl^e, format I, arg I ... ) 



jl@priit(fQrmat, args» etream) 



vajtot *®rg®| 



DESOEIPTION 

Print/ places output on the standard output stream stdout. Fprintf places output on the named 
output stream. Sprintf places 'output' in the string s, followed by the character '\0'. All of these 
routines work by calling the implementation-dependent routine _doprni, using the variable-length 

argument facilities of vo,rar§8{Z). 

Each of these fiinctions converts, formats, and prints its arguments after the first under control of 
the first argument. The first argument is a character string which contains two types of objects: 
plain characters, which are simply copied to the output stream, and conversion specifications, 
each of which causes conversion and printing of the next successive arf 

Each conversion specification is introduced by the character %. Following the %, there may be 

® an optlonallmiinus sign '— which specifies left adjuBtment ot iMe converted value in the 



® &1I optional digit string specifying a field width; if the converted value has fewer charac- 

ters thai the field width it will be blank-padded on the left (or right, if the left- 
adjustment indicator has been given) to make up the field width; if the field width begins 
with a zero, sero-padding will be done instead of blank-padding; 

m an optional period '•' which serves to separate the field width from the next digit string; 

® an optional digit string specifying a precision which specifies the number of digits to 

appear after the decimal point, for e- and f-conversion, or the maximum number of char- 
acters to be printed from a string; 

• an optional '#' character specifying that the value should be converted to an "alternate 
form". For e, d, s, and u, conversions, this option has no effect. For o conversions, the 
precision of the number is increased to force the first character of the output string to a 
zero. For x(X) conversion, a non-zero result has the string Ox(OX) prepended to it. For 
e, E, f, g, and 6, conversions, the result will always contain a decimal point, even if no 
digits follow the point (normally, a decimal point only appears in the results of those 
conversions if a digit follows the decimal point). For g and 6 conversions, trailing zeros 
are not removed from the result as they would otherwise be. 

• the character 1 specifying that a following d, o, x, or u corresponds to a long integer arg. 

• . a character which indicates the type of conversion to be applied. 
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A field width or precision may be '*' instead of a digit string. In this case an integer ar^ supplies 
the field width or precision. 

The conversioa characters and their meanings are 

dox The integer org is converted to decimal, octal, or hexadecimsd notation respectively. 

f The float or double arg is converted to decimal notation^ in the style '[-jddd.ddd* where 

the number of d's after the decimal point is equal to the precision specification for the 
argument. If the precision is missing, 6 digits are given; if the precision is explicitly 0, no 
digits and no decimal point are printed. 

e The float or double arg b converted in the style '|-]d.ddde± dd' where there is one digit 

before the decimal point and the number after is equal to the precision specification for 
the argument; when the precision is nussihg, & digits are produced. 

g The float or double arg is printed in style d, in style f, or in style e,^ whichever gfves^fuU 

precision in minimum space. 

The %e, %f, and %z formats print IEEE indeterminate values (infinity or not>arnumber) as 
"Infinity "^ or "Nan" respectively. 

e The character arg is printed. 

■ Arg is taken to be a string (character pointer) and characters from the string are printed 

until a null character or until the number of characters indicated by the precision 
specification is reached; however if the precision is or missing all characters up to a null 
are printed. 

u The unsigned integer arg is converted to decimal and printed (the result will be in the 

range through MAXUINT, where MAXUINT equals 4294967295 on a VAX-11 or Sun 
and 65535 on a PDP-11). 

% Print a '%^; no argument is converted. 

In no case does a non-existent or small field width cause truncation of a field; padding takes place 
only if the specified field width exceeds the actual width. Characters generated by printf are 
printed by putc{ZS). 

Examples 

To print a date and time in the form 'Sunday, July- 3, 10:02', where weekday and month are 
pointers to null-terminated strings: 

printf(''%8, %s %d, %02d:%02d'', weekday, month, day, hour, min); 

To print jt io Jj decmials: 

printf("pi :« %.5r,^4*atan(1.0)); 

SEE ALSO 

putc(3S), scanf(3S), ecvt(3) 

BUGS 

Very wide fields (>128 characters)^ foil. 

The values "Infinfty" and "Nan" cannot be read by *cfln/[3S). 
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NAME 

putc, putchar, fputc, putw - put character or word on a stream 

SYNOPSIS 

#lnclude <8tdlo.h> 

Int pute(cy stream) 

char e| 

FILE *itream} 

putchar(e) 

flpute(e, stream) 
FILE ""streami 

putw(w, stream) 
FILE *stream| 

DESCRIPTION 

Pute appends the character e to the named output etream. It returns the character written. 

Putehar{c) is defined as pute{e, stdout). 

Fpute behaves like pute, but is a genuine function rather than a macro. 

Putw appends C Int (word) w to the output etream. It returns the integer written. Putw neither 
assumes nor causes special alignment in the file. 

SEE ALSO 

fopen(3S), fclose(3S), getc(3S), puts(3S), printf(3S), fread(3S) 

DLiGNOSTICS 

These functions return the constant EOF upon error. Since this is a good integer, /error(3S) 
should be used to detect putw errors. 



BUGS 



Because it is implemented as a macro, pute treats a stream argument with side effects improperly. 
In particular "putc(c, *f+ -I- )" doesn't work sensibly. 

Errors can occur long after the call to pute. 

Data files written and read with putw and getw are not portable; the size of an Int and the order 
in which data bytes are stored within an Int varies between machines. 
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NAME 

puts, fputs - put a string on a stream 

SYNOPSIS 

#lnclud« <8tdio.h> 

putB(i) 
char *■! 

fputs(i, stream) 
char *Bi 
FILE *itream| 

DESCRIPTION 

Putf copies the null-terminated string 9 to the standard output stream dtdout and appends a 
newline character. 

Fputa copies the null-terminated string 9 to the named output 9tream. 

Neither routine copies the terminal null character. 

SEE ALSO 

ropen(3S), get8(3S), putc(3S), printf(3S), ferror(3S) 
fread(3S) for /write 

BUGS 

Put9 appends a newline, fput9 does not, all in the name of backward compatibility. 
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NAME 

seaal, fseanf, sscanf - formatted input conversion 

SYNOPSIS 

#inelud« <Btdio.h> 

seaiif(format | , pointer j . . . ) 
eh&w ""format) 

fseai&f(etreamy format [ , pointer ] . . . ) 
FILE ^stream) 
char ^format) 

Bscanf(8f format [ , pointer ) . . . ) 
char *s, *format| 

DESCRIPTION 

Scanf reads from the standard input stream stdin. Fscanf reads from the named input stream. 
Sscanf reads from the character string s. Each function reads characters, interprets them accord- 
ing to a format, and stores the results in its arguments. Each expects as arguments a control 
string format, described below, and a set of pointer arguments indicating where the converted in- 
put should be stored. 

The control string usually contains conversion specifications, which are used to direct interpreta- 
tion of input sequences. The control string may contain: 

1. Blanks, tabs or newlines, which match optional white space in the input. 

2. An ordinary character (not %) which must match the next character of the input stream. 

3. Conversion specifications, consisting of the character %, an optional assignment suppressing 
character *, an optional numerical maximum field width, and a conversion character. 

A conversion specification directs the conversion of the next input field; the result is placed in the 
variable pointed to by the corresponding argument, unless assignment suppression was indicated 
by "'. An input field is defined as a string of non-space characters; it extends to the next inap- 
propriate character or until the field width, if specified, is exhausted. 

The conversion character indicates the interpretation of the input field; the corresponding pointer 
argument must usually be of a restricted type. The following conversion characters are legal: 

% a single '%* is expected in the input at this point; no assignment is done. 

d a decimal integer is expected; the corresponding argument should be an integer pointer. 

o an octal integer is expected; the corresponding argument should be a integer pointer. 

91 a hexadecimal integer is expected; the corresponding argument should be an integer pointer. 

a character string is expected; the corresponding argument should be a character pointer 
pointing to an array of characters large enough to accept the string and a terminating '\0', 
which will be added. The input field is terminated by a space character or a newline. 

e a character is expected; the corresponding argument should be a character pointer. The nor- 
mal skip over space characters is suppressed in this case; to read the next non-space charac- 
ter, try '%ls'. If a field width is given, the corresponding argument should refer to a charac- 
ter array, and the indicated number of characters b read. 

e a floating point number is expected; the next field is converted accordingly and stored 
f through the corresponding argument, which should be a pointer to a float. The input format 
for floating point numbers is an optionally signed string of digits possibly containing a de^ 
cimal point, followed by an optional exponent field consisting of an E or e followed by an op- 
tionally signed integer. 

1 indicates a string not to be delimited by space characters. The left bracket is followed by a 
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set of characters and a right bracket; the characters between the brackets define a set of 
characters making up the string. If the first character is not circumflex {"), the input field is 
all characters until the first character not in the set between the brackets; if the first charac- 
ter after the left bracket is *, the input field is all characters until the first character which is 
in the remaining set of characters between the brackets. The corresponding argument must 
point to a character array. 

The conversion characters d^ o and x may be capitalized or preceded by 1 to indicate that a 
pointer to long rather than to int is in the argument list. SimBarly, the conversion characters • 
or f may be capitalized or preceded by I to indicate a pointer to double rather than to float. 
The conversion characters d^o and x may be preceded by h to indicate a pointer to short rather 
than to int. 

The scan/ functions return the number of successfully matched and assigned input items. This 
can.be used to decide how many input items were found. The constant EOF & returned upon 
end of input; note that this is different from 0^ whicb means that no conversion was done; if 
conversion was intended^ it war frustrated by an inappropriate character in the input.. 

Tor example^ the caH 

int i; float xpchar name|50}; 
8canf("%d%f%s% &f, &x, name); 

with the input line 

25 54.32E~1 thompson 

will assign to t the value 25, x the value 5.432, and name will contain thomp9on\0'. Or, 

int i; ffoat x; char name[50]; 
8canf(''%2d%f%*d%[1234567890]*', &i, &x, name); 

with input 

56780 0123 56a72 

will assign 56 to i, 780.0 to x, skip '0123', and place the string '56\0' in name. The next call to 
getchar will return 'a*. 

SEE ALSO 

atof(3), getc(3S), printf(3S) 

DIAGNOSTICS 

The ecanf functions return EOF on end of input, and a short count for missing or illegal data 



items. 



BUGS 



The success of literal matches and suppressed assignments is not directly determinable. 

Scan/ cannot read the strings which printf{3S) generates for IEEE indeterminate floating point 
values. 

5can/ provides no way to convert a number in any arbitrary base (decimal, hex or octal) based on 
the traditional C conventions (leading or Ox). 
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NAME 

setbuf, setbuffer, setlinebuf - assign buffering to a stream 

SYNOPSIS 

^Include <8tdio.h> 

8etbuf(8treamt buf) 
FILE ^fitre&m} 
eh&r ^bufi 

eetbtalfer(8tream, buf» 8l8e) 
FILE ^streami 
char ""buff 

fait eli^i 



FILE ^streami 

DESCRIPTION 

The three types of buffering available are unbuffered, block buffered, and line buffered. When an 
output stream is unbuffered, information appears on the destination file or terminal as soon as 
written; when it is block buffered many characters are saved up and written as a block; when it is 
line buffered characters are saved up until a newline is encountered or input is read from stdin. 
Fflmh (see /ddfe(3S)) may be used to force the block out early. Normally all files are block 
buffered. A buffer is obtained from maUoc{S) upon the first getc or putc{3S) on the file. If the 
itandard stream stdeyt refers to a terminal it is line buffered. If the standard stream stderr 
refers to a terminal it is line buffered. 



is used after a stream has been opened but before it is read or written. The character ar- 
ray buf is used instead of an automatically allocated buffer. If buf is the constant pointer NULL, 
lEput/output will be completely unbuffered. A manifest constant BUFSIZ tells how big an array 
is needed: 

cfear buf[BUFSIZl; 

Selbuj^er, an alternate form of setbuf, is used after a stream has been opened but before it is read 
Of written. The character array ftt^ whose size is determined by the size argument is used instead 
of an automatically allocated buffer. If buf is the constant pointer NULL, input/output will be 

completely unbuffered. 

Setlinebuf is used to change stdout or stderr (only) from block buffered or unbuffered to line 
buffered. Unlike setbuf znd setbuf er it can be used at any time that the file descriptor is active. 

A file can be changed from unbuffered or line buffered to block buffered by using freopen (see 
fopen{ZB)). A file can be changed from block buffered or line buffered to unbuffered by using freo- 
pen followed by setbuf with a buffer argument of NULL. 

SEE ALSO 

fopen(3S), getc(3S), putc(3S), malloc(3), fclose(3S), puts(3S), printf(3S), fread(3S) 
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NAME 

UDgetc - push character back into input stream 

SYNOPSIS 

#include <BtdIo.h> 

ungetc(e, stream) 
FILE *8tre«m| 

DESCRIPTION 

Ungete pushes the character c back on an input stream. That character will be returned by the 
next getc call on that stream. Ungete returns c. 

One character of pushback is guaranteed provided something has been read from the stream and 
the stream is actually buffered. Attempts to push EOF are rejected. 

An f9eek{3S) erases all memory of pushed back characters. 

SEE ALSO 

getc(3S), setb«f(as), fseekfSS) 

DIAGNOSTICS 

Vngttc returns EOF if it can^t push a character back. 
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NAME 

intro - introduction to other libraries 

DESCRIPTION 

This section contains manual pages describing other libraries, which are available only from C. 
The list below includes libraries which provide device independent plotting functions, terminal 
independent screen management routines for two dimensional non-bitniap display terminals, and 
functions for managing data bases with inverted indexes. All functions are located in separate 
libraries indicated in each manual entry. 



FILES 



/usr/lib/libcurses.a screen management routines (see cur«e9(3x)) 

/usr/lib/libdbm.a data base management routines (see dbm{Sx)) 

/usr/lib/libmp.a multiple precision math library (see mp(3x)) 

/usr/lib/libplot.a plot routines (see plot{Zx)) 

/U8r/lib/lib300.a 

/usr/lib/libSOOs.a 

/usr/lib/lib450.a 

/usr/lib/lib4014.a 

/usr/lib/libtermcap.a terminal handling routines (see termcap{3x)) 

/u8r/lib/libtermcap_p.a 

/usr/lib/libtermlib. a 

/usr/lib/libtermlib_p.a 
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NAME 

curses - screen functions with "optimal" cursor motion 

SYNOPSIS 

ce { flags ] files -Icurses -Itermcap { libraries ] 

DESCRIPTION 

These routines give the user a method of updating screens with reasonable optimization. They 
keep an image of the current screen, and the user sets up an image of a new one. Then the 
refreshf) telb the routines to make the current screen look like the new one. In order to initialize 
the routines, the routine initacrf) must be called before any of the other routines that deal with 
windows and screens are used. The routine endwinQ should be called before exiting. 

SEE ALSO 

ioctl(2), getenY(3), tty(4), termcap(5) 



FUNCTIONS 

addch(ch) 

add8tr(&tr) 

box(win,vert,hor) 

crmodeQ 

clear() 

clearok(scr,boolf) 

clrtobot() 

clrtoeol() 

delchO 

deleteln() 

delwin(win) 

echo() 

endwin() 

erase() 

getch() 

getcap(name) 

getstr(str) 

gettmode() 

getyx(win,y,x) 

inch() 

initscr() 

insch(c) 

insertln() 

leaveok(win,boolf) 

longname(termbuf,name) 

move(y,x) 

ravcur(lasty ,lastx,newy ,newx) 

newwin(lines,cols,begin_y,begin_;c) 

nlO 

nocrmode() 

noecho() 

nonl() 

noraw() 

overlay (win 1 , win2) 

overwrite(win 1 ,win2) 

printw(fmt,argl,arg2,...) 

raw() 

refresh() 

re8etty() 



add a character to ttdacr 

add a string to stdaer 

draw a box around a window 

set cbreak mode 

clear stdaer 

set clear flag for acr 

clear to bottom on stdser 

clear to end of line on etdicr 

delete a character 

delete a line 

delete win 

set echo mode 

end window modes 

erase etdacr 

get a char through stdser 

get terminal capability name 

get a string through stdser 

get tty modes 

get (y,x) co-ordinates 

get char at current (y,x) co-ordinates 

initialize screens 

insert a char 

insert a line 

set leave flag for win 

get long name from termbuf 

move to (y,x) on atdacr 

actually move cursor 

create a new window 

set newline mapping 

unset cbreak mode 

unset echo mode 

unset newline mapping 

unset raw mode 

overlay winl on win2 

overwrite winl on top of win2 

printf on atdscr 

set raw mode 

make current screen look like etdacr 

reset tty flags to stored value 
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•avettyO 

8canw(fmt,argl,arg2....) 

scroll(win) 

scrollok (win ,boolf ) 

8etterm(naine) 

8tattdeod() 

8tandout() 

8ubwin(win,Iine8,col8,begin_y,beginjx) 

touchwiii(win) 

unctrl(ch) 

waddch(win,ch) 

wadd8tr(win,8tr) 

wclear(win) 

wclrtobot(win) 

wclrtoeol(win) 

wdelch(win,c) 

wdeleteb(wm) 

wera8e(wiii) 

wgetch(wiD) 

wget8tr(wiii,8tr) 

winch(win) 

win8ch(win,c) 

win8ertln(win) 

wmove(win,y,x) 

wpriiitw(wiii,fint,argl,arg2,...) 

wrefre8h(win) 

W8canw(win,fint,argl,arg2,...) 

W8tandend(wiii) 

wstandout(win) 



stored current tty flags 

Bcanf through stdacr 

scroll win one line 

set scroll flag 

set term variables for name 

end standout mode 

start standout mode 

create a subwindow 

"change" all of win 

printable version of ch 

add char to win 

add string to win 

clear win 

clear to bottom of win 

clear to end of line on win 

delete char from win 

delete line from win 

erase win 

get a char through win 

get a string through win 

get char at current (y,x) in win 

insert char into win 

insert line into win 

set current (y,x) co-ordinates on win 

printf on win 

make screen look like win 

scanf through win 

end standout mode on win 

start standout mode on win 
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NAME 

dbminit, fetch, store, delete, firstkey, nextkey - data base subroutines 

SYNOPSIS 

typedef struct { 

char *dptr; 
Int dsise} 
} datum; 

dbmlnit(flle) 
char *flle) 

datum fetch(ke3r) 
datum key} 

8tore(key, content) 
datum key, content} 

ddete(key) 
datum key} 

datum flrstkeyQ 

datum nextkey(key) 
datum key} 

DESCRIPTION 

These functions maintain key /content pairs in a data base. The functions will handle very large 
(a billion blocks) databases and will access a keyed item in one or two file system accesses. The 
functions are obtained with the loader option -Idbm. 

Keys and conttntB are described by the datum typedef. A datum specifies a string of dsize bytes 
pointed to by dptr. Arbitrary binary data, as well as normal ASCII strings, are allowed. The data 
base is stored in two files. One file is a directory containing a bit map and has '.dir' as its suffix.- 
The second file contains all data and has '.pag' as its suffix. 

Before a database can be accessed, it must be opened by dbminit. At the time of this call, the files 
^e.dir and file.pakH must exist. (An empty database is created by creating zero-length '.dir' and 
'.pag' files.) 

Once open, tlie data stored under a key is accessed by fetch and data is placed under a key by 
ttore. A key (and its associated contents) is deleted by delete^ A linear pass through all keys in a 
database may be made,, in an (apparently) random order^ by use of ftratkey and nextkey. Firatkey 
will return the first key in the database. With any key nextkey will return the next key in the 
database. This code will traverse the data base: 

for (key «• firstkeyQ; key .dptr !»* NULLr key » nextkey (key)) 

DIAGNOSTICS 

Alt functions that return an int indicate errors with negative values. A zero return indicates ok. 
Routines that return a datum indicate errc^s with a null (0) dptr, 

BUGS 

The '.pag*^ file will contain holes so that its apparent siiee is about four times its actual content. 
Older UNIX systems may create real file blocks for these holes when touched. These files cannot 
be copied by normal means (cp, cat, tp, tar, ar) without filling in the holes. 

Dptr pointers returned by these subroutines point into static storage that is changed by subse- 
quent calls. 

The sum of the sizes of a key /content pair must not exceed the internal block size (currently 1024 
bytes). Moreover all key /content pairs that hash together must fit on a single block. Store will 
return an error in the event that a disk block fills with inseparable data. 
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Delete does not physically reclaim file space, although it does maJce it available for reuse. 

The order of keys presented by firetkey and nexikey depends on a hashing function, not on any- 
thing interesting. 

There are no interlocks and no provisionunreliable cache flushing; thus concurrent updating and 
reading is risky. 
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NAME .... 

itom, madd, msub, mult, mdiv, min, mout, pow, gcd, rpow - multiple precision integer arithmetic 

SYNOPSIS 

#include <mp.h> 

madd(s, b, c) 
MINT *a, *b, ♦c| 

msub(a, by c) 
MINT *«, ♦b, •c> 

intilt(a» hi e) 
MINT ♦a, *b, *ct 

mdlv(a, by^ q, r) 
MINT*a,*W*q,*tr 

mtii(a). 
MINl^aj^ 

motit(a) 
MINT*af 

powCa^b, c, d) 
MINTV*br*c, Ml 

ged(a, b, c) 
MINT ♦a, ♦b, *c} 

rpow(a» n, b) 
MINT ♦a, ♦bi 
short n; 

m8qrt(a, h, r) 
MINT ♦a, ♦b, *r| 

•div(a, n, q, r) 
MINT ♦a, «q| 
short n, *r) 

MINT *itom(n) 
short n| 

DESCRIPTION 

These routines perform arithmetic (m integers of arbitraiy length. The integers are stored using 
the defined type MINT. Pointers to a MINT should be initialized udng the function itom, which 
sets the initial value to n. After that space is managed automatically by the routines. 

Madd, msub and muU assign to their third arguments the sum, difference, and product, respec- 
tively, of their first two arguments. Mdiv assigns the quotient and remainder, respectively, to its 
third and fourth arguments. Sdiv b like mdiv except that the divisor is an ordinary integer. 
Msqrt produces the square root and remainder of its first argument. Rpow calculates a raised to 
the power b, while pow calculates this reduced modulo m. Min and mout do decimal input and 
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output. 

Use the —Imp loader option to obtain access to these functions. -Imp. 

DIAGNOSTICS 

Illegal operations and running out of memory produce messages and core images. 

FILES 

/usr/lib/libmp.a 
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NAME 

openpl, erase, label, line, circle, arc, move, cont, point, Unemod, space, closepl - graphics interface 

SYNOPSIS 

openplQ 

eraseQ 

label(s) 
char sQ} 

!ine(xl,yl,x«,y2) 

circle(X| y, r) 

arcCx, y, xO, yO, xl, yl) 

move(Xf y) 

eont(x> y V 

polnt(x, 3^ 

&ieinod(s) 
char sQi 

spaee(xO, yO, xl, yl) 

cloteptQ 

DESORIPTIwr 

These snbrovtines generate graphic output in a relative^ devfce4ii<lependent manner. See pht{5)^ 
for a description of their effect. Openpt muirt be used before any of the others to open the device 
for writing. Cloeepl flushes the output. 

String arguments to labet B,nd ttnemod are nttU>terminated,^ and do^not contain ne^i^nes^ 

Various flavors of these functions exist for different output devices. They are obtained by the fol- 
lowing ld{l) optionsr 

-Iplot device-independent graphics stream^ «i standard oQ^)ut tta pht{lG) filters 

-1300 GSI 3Q0 terminal 

-laOOt GSI 300S terminal 

-U50 DASI 450 terminal 

-14014 Tektronix 4014 terminal 

SEE ALSO 

plot(5), plot(lG), graph(lG) 



FILEa 



/usr/lib/iibplot.a 

/usr/lib/libSOO.a 

/U8r/lib/lib300s.a 

/U8r/lib/tib450.a 

/usr/lib/lib4014ji 
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NAME 

tgeteat, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal independent operation routines 

SYNOPSIS 

eh&T PC| 
char *BC} 
char *UPj 
short ospesd} 

tget@nt(bp, name) 
char ^bp, '"name; 

tgetnum(ld) 
char "^id; 

tsetSag(ld) 
char ""tdi 

char * 

tgetstr(id, area) 
char *iA, **areat 

char * 

tgoto(emy desteolf destline) 

char *em| 

tputs(epr aflbnt, oute) 
register char *cp} 

lot affentf 
Int (*'oute)(); 

DESCRIPTION 

These functions extract and use capabilities from the terminal capability data base termcap{b). 
These are low level routines; see cur9ea(3X) for a higher level package. 

Tgetent extracts the entry for terminal name into the buffer at bp. Bp should be a character buffer 
of size 1024 and must be retained through all subsequent calls to tgetnum, tgetflag, and tgetstr. 
Tgetent returns -1 if it cannot open the termcap file, if the terminal name given does not have 
an entry, and 1 if all goes well. It will look in the environment for a TERMCAP variable. If 
found, and the value does not begin with a slash, and the terminal type name is the same as the 
environment string TERM, the TERMCAP string is used instead of reading the termcap file. If 
it does begin with a slash, the string is used as a path name rather than /etc/ termcap. This can 
speed up entry into programs that call tgetent, aa well as to help debug new terminal descriptions 
or to make one for your terminal if you can't write the file /etc/ termcap. 

Tgetnum gets the numeric value of capability id, returning -1 if is not given for the terminal. 
Tgetflag returns 1 if the specified capability is present in the terminal's entry, if it is not. 
Tgetstr gets the string value of capability id, placing it in the buffer at area, advancing the area 
pointer. It decodes the abbreviations for this field described in termcap{b), except for cursor 
addressing and padding information. 

Tgote returns ft cursor addressing string decoded from cm to go to column destcol in line destline. 
It uses the external variables UP (from the up capability) and BC (if be is given rather than bs) 
if necessary to avoid placing \n, 'D or '® in the returned string. (Programs which call tgoto 
should be sure to turn off the XTABS bit(s), since tgoto may now output a tab. Note that pro- 
grams using termcap should in general turn off XTABS anyway since some terminals use control I 
for other functions, such as nondestructive space.) If a % sequence is given which is not under- 
stood, then tgoto returns "OOPS". 
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Tputa decodes the leading padding information of the string cp; affcnt gives the number of lines 
affected by the operation, or 1 if this is not applicable, oute is a routine which is called with each 
character in turn. The external variable o»peed should contain the encoded output speed of the 
terminal as described in tty{4). The external variable PC should contain a pad character to be 
used (from the pc capability) if a null (^0) is inappropriate. 



FILES 



/usr/lib/libtermcap.a -Itermcap library 
/etc/termcap data base 

SEE ALSO 

ex(l), curses(3X), tty(4), termcap(5) 
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NAME 

intfo - introduction to special files and hardware support 

DESCRIPTION 

This section describes device interfaces to the operating system for disks, tapes, serial communicar 
tions, high-speed network communications, and other devices such as mice, frame buffers and win- 
dows. 

The operating system can be built with or without many of the devices listed here; we show for 
most devices the syntax in a description to config{8) to cause the device to be included in a sys- 
tem. For mose devices we also give a DIAGNOSTICS section which lists the error messages 
which the device may produce to appear on the system console, and in the system error log file 
/usr/adm/messages. 

Section 4 has been broken up according to machine independent device interfaces, "4" entries, 
Sun specific devices "4S", Vax specific devices "4V", manual pages for protocol families "4F", 
and manual pages for protocols and raw interfaces "4P". 

Most devices on the Sun workstation exist on the Multibus, whose common properties are 
described in m6(4S). 

Devices which are present in every kernel include a driver for the paging drum drum{A), drivers 
for accessing physical, virtual and i/o memory mem(4S) and the drivers for the data sink 
/dev/nuU, nu«(4). 

Communications lines are most often used with the terminal driver described in tty{i). The ter- 
minal driver runs on communications lines provided either by a communications driver such as 
oel(4S) or z8{iS) or on a more virtual terminal, either provided by the Sun console monitor 
con8(4S) or a true pseudo-terminal pty{4) used in applications such as windowing or remote net- 
working. 

Magnetic tapes all provide the interface described in mtio{4). Tape devices for the Sun include 
or(4S) and tm{4S). 

Disk controllers provide standard block and raw interfaces, as well as a set of ioctl's defined in 
dMo{4S) supporting disk formatting and bad block handling. Drivers available for the Sun 
include xy{4S) and tp(4S). 

The operating system supports one or more protocol families supporting local network communi- 
cations. The only complete protocol family in this version of the system is the Internet protocol 
family me{(4F). Each protocol family provides basic services to each protocol implementation 
such as packet fragmentation and reassembly, routing, addressing and basic transport. A protocol 
family is normally composed of a number of protocols, one per 80cket(2) type. It is not required 
that a protocol family support all socket types. 

The primary network support is for the Internet protocol family described in me{(4F). Major pro- 
tocob in this family include the Internet Protocol tp(4P) describing the universal datagram for- 
mat, the stream Transport Control Protocol tcp{iF), the User Datagram Protocol udp(4F), the 
Address Resolution Protocol arp (4P), and the Internet Control Message Protocol tcmp(4P). The 
primary network interface is for the 10 Megabit Ethernet ec(4S); a software loopback interface 
/0(4) also exists. General properties of these (and all) network interfaces are described in »/(4N). 

The general support in the system for local network routing is described in ronting(4N); these 
facilities apply to all protocol families. 

Miscellaneous devices Include color frame buffers c^(4S), monochrome frame buffers biif^{4S), the 
console frame buffer, fb{4S), the console mouse mouae(4S) and the window devices unn(4S). 
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NAME 

ar - Archive 1/4 inch Streaming Tape Drive 

SYNOPSIS 

device arO at mbO car 0x200 priority 3 

DESCRIPTION 

The Archive tape controller is a Sun 'QIC-II' interface to an Archive streaming tape drive. It 
provides a standard tape interface to the device, see m<to(4)^ with some deficiencies listed under 
BUGS below. 

The maximum blocksize for the raw device is limited only by available memory. 

FILES 

/dev/rarO 

/dev/nrarO non-rewinding^ 

SEE ALSO 

mtio(4), tm(4S) 

Archive Intelligent Tape Drive Theory of Operation^ Archive C(»poration (Sun 8000-1058-01) 
Archive Froduct Manual (Sfdewinder 1/4" Streammg Cartridge Tape Drive) (Sun 800-0628-01) 
Sun 1/4"^ Tape Interfaee -User Manual (Sun 8Q0-041M)1) 

DIAGNOSTICS^ 

ar%d» would not inltlattEe. 

ar%di already open. The tape can be open l^ onl^ one procesrat a time. 

ar%di no bucIi drive. 

ar%d: no cartridge in drive. 

ar%d: cartridge is write protected.. 

an interrupt IVom unitiaUzed controller %x. 

ar%di many retries, consider retiring ^is txpe. 

ar%dt %h error at bloclc # %d punted. 

ar%ds %h error at block # %d. 

an giving up on Rdy, try again. 



BUGS 



The tape cannot reverse direction so BSF, BSR and FSR are not available. 

The system will hang if the tape is removed while running. 

When using the raw device, the number of bytes in any given transfer must be a multiple of 512 
bytes. If it is not, the device driver returns an error. 
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NAME 

arp - Address Resolution Protocol 

SYNOPSIS 

pseudo-devlce ether 

DESCRIPTION 

ARP is a protocol used to dynamically map between DARPA Internet and lOMb/s Ethernet 
addresses. It is used by all the lOMb/s Ethernet interface drivers. 

ARP caches Internet-Ethernet address mappings. When an interface requests a mapping for an 
address not in the cache, ARP queues the message which requires the mapping and broadcasts a 
message on the associated network requesting the address mapping. If a response is provided, the 
new mapping is cached and any pending messages are transmitted. ARP will queue at most one 
packet while waiting for a mapping request to be responded to; only the most recently "transmit- 
ted" packet is kept. 

To enable communications with systems which do not use ARP, ioctk are provided to enter and 
delete entries in the Intemet-to-Ethemet tables. Usage: 

^include <8y8/loctl.h> 
#include <sy8/8ocketi^h> 
#include <net/lf.h> 
struct arpreq arpreq; 

loctl(8, SIOCSARP, (caddr_t)&arpreq)) 

loetl(B, SIOCGARP, (eaddr_t)&arpreq)| 

toet!(8, SIOCDARP, (eaddrjfc)&ftrpreq)| 
Each ioctl takes the same structure as an argument. SIOCSARP sets an ARP entry, SIOCGARP 
gets an ARP entry, and SIOCDARP deletes an ARP entiy. These ioctls may be applied to any 
socket descriptor 9/but only by the super-user. The arp re? structure contains: 

/* 
* ARP ioctl request 

V 

struct arpreq { 

struct sockaddr arp_i)a; /* protocol address */ 

struct sockaddr arpjha; /* hardware address */ 

int arpjBags; /* flags */ 

>; 

/* arp_flags field values */ 

#define ATF_COM 2 /* completed entry (arp_ha valid) */ 

#defincATFJPERM 4 /* permanent entry */ 

#define ATF J»UBL 8 /* publish (respond for other host) ♦/ 

The address family for the arp_pa sockaddr must be AF_INET; for the arp_ha sockaddr it must 
be AF_UNSPEC. The only flag bits which may be written are ATF_PERM and ATF.PUBL. 
ATFJPERM causes the entry to be permanent if the ioctl call succeeds. The peculiar nature of 
the ARP tables may cause the ioctl to fail if more than 4 (permanent) Internet host addresses 
hash to the same slot. ATF_PUBL specifies that the ARP code should respond to ARP requests 
for the indicated host coming from other machines. This allows a Sun to act as an "ARP server" 
which may be useful in convincing an ARP-only machine to talk to a non-ARP machine. 

ARP watches passively for hosts impersonating the local host (i.e. a host which responds to an 
ARP mapping request for the local host's address). 

DL^GNOSTICS 

duplicate IP addreas!! sent f^om ethernet address: %xs%x:%xs%x:%x:%x. ARP has 
discovered another host on the local network which responds to mapping requests for its own 
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Internet address. 

SEE ALSO 

ec(4S), ie(4S), inet(4F), arp(8C), ifconfig(8C) 

An Ethernet Address Resolution Protocol, RFC826, Dave Plummer, MIT (Sun 800-1059-01) 

BUGS 

ARP packets on the Ethernet use only 42 bytes of data, however, the smallest legal Ethernet 
packet is 60 bytes (not including CRC). Some systems may not enforce the minimum packet size, 
others will. 
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NAME 

bk - line discipline for machine-machine communication 

SYNOPSIS 

pseudo-devlce bk 

DESCRIPTION 

This line discipline provides a replacement for the tty driver tty{4) when high speed output to and 
especially input from another machine is to be transmitted over an asynchronous communications 
line. The discipline was designed for use by a (now obsolete) store-and-forward local network run- 
ning over serial lines. It may be suitable for uploading of data from microprocessors into the sys- 
tem. If you are going to send data over asynchronous communications lines at high speed into 
the system, you must use this discipline, as the system otherwise may detect high input data rates 
on terminal lines and disable the lines; in any case the processing of such data when normal ter- 
minal mechanisms are involved saturates the system. 

The line discipline is enabled by a sequence: 

#include <8gtty.h> 

int Idise » NETLDISC, Aides; ... 

ioetl(fllde8, TIOCSETD, &ldi8c); 

A typical application program then reads a sequence of lines from the terminal port, checking 
header and sequencing information on each line and acknowledging receipt of each line to the 
sender, who then transmits another line of data. Typically several hundred bytes of data and a 
smaller amount of control information will be received on each handshake. 

The old standard teletype discipline can be restored by doing: 

Idlsc == OTTYDISCj 
loctl(fllde8, TIOGSETD, &ldi8c); 

While in networked mode, normal teletype output functions take place. Thus, if an 8 bit output 
data path is desired, it is necessary to prepare the output line by putting it into RAW mode using 
ioctl(2). This must be done before changing the discipline with TIOCSETD, as most ioctl(2) 
calls are disabled while is network line-discipline mode. 

When in network mode, input processing is very limited to reduce overhead. Currently the input 
path is only 7 bits wide, with newline the only character terminating an input record. Each input 
record must be read and acknowledged before the next input is read as the system refuses to 
accept any new data when there is a record in the buffer. The buffer is limited in length, but the 
system guarantees to always be willing to accept input resulting in 512 data characters and then 
the terminating newline. 

User level programs should provide sequencing and checksums on the information to guarantee 
accurate data transfer. 

SEE ALSO 

tty(4) 

DIAGNOSTICS 

None. 
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NAME 

bwone - Sun one black and white frame buffer 

SYNOPSIS 

device bwoneO at mbO car OxcOOOO priority 3 

DESCRIPTION 

The bwone interface provides access to Sun-1 black-and-white graphics controller boards. It sup- 
ports the FBIOGTYPE ioctl which a program can use to inquire as to the characteristics of the 
display device; see fbio{4S) 

It supports the FBIOGPIXRECT ioctl which allows Sun Windows to be run on it; see fbt0{4S) 

Reading or writing to the frame buffer is not allowed - you must use the mmap{2) system call to 
map the board into your address space. 

FILES 

/dev/bwonelQ^O]^ 

SEE ALSO 

mmap(2), fb(4S), fbio(4S) 

Sun 1024 Video^Board - User Manual (Sun 800-042a). 

DIAGNOSTICS 
None. 

BUGS 

Use of vertical^retrace interrupts is not^supported. 
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NAME 

bwtwo - Sun two black and white frame buffer 

SYNOPSIS 

device bwtwoO at mbO car 0x700000 priority 3 

DESCRIPTION 

The bwtwo interface provides access to Sun-2 Monochrome Video Controller boards. It supports 
the FBIOGTYPE ioctl which a program can use to inquire as to the characteristics of the display 
device; see fbio{iS) 

It supports the FBIOGPIXRECT ioctl which allows Sun Windows to be run on it; see fbio{AS) 

Reading or writing to the frame buffer is not allowed - you must use the mmap{2) system call to 
map the board into your address space. 

FILES 

/dev/bwtwo(0-9l 

SEE ALSO 

mmap(2), fb(4S), fbiQ(4S) 

DIAGNOSTICS 

None. 

BUGS 

Use of vertical-retrace interrupts is not supported. 
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NAME 

cgone - Sun-l color graphics interface 

SYNOPSIS 

device cgoneO at mbO ear OxeSOOO priority 3 

DESORIFTION 

The cgone interface provides access to the Sun-1 color graphics controller board, which is nor- 
mally supplied with a 13* or 19" RS170 color monitor. It provides the standard frame buffer 
interface as defined m fbio{4S). 

It supports the FBIOGPIXRECT iocti which allows Sun Windows to be run on it; see fbia{4S) 

The hardware consumes 16 kilobytes of Multibus memory space. The board starts at standard 
addresses CbcElSOOO or QxECOOO. The board must be configured for interrupt level 3. 

FILES 

/dev/cgone^I»9|: 

SEE ALSO 

mmap(2), fbio(4S) 

Sun Color Video Board User's Manual (Sun 8000-0399, Rev B| 

Barco 0033^ Color Display 120VAC Operation Instructfons (13**) (Sun 800-1002-01) 

Barco Color Display CD 252 120/220VAa Operation Guide (19*) (Sun 800*1003-ai) 

DIAGNOSTICS 

None. 

BUGS 

Use of color board vertical-retrace interrupts is not supported. 
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NAME 

cons - driver for Sun console 

SYNOPSIS 

None; included in standard system. 

DESCRIPTION 

Cona is an indirect driver for the Sun workstation console, which implements a standard UNIX 
terminal. Cona is implemented by calling the PROM resident monitor to perform I/O to and 
from the current system console, which is either a Sun frame buffer or an RS232 port. 

When the Sun window system u;m(4S) is active, console input is directed through the window sys- 
tem rather than being read from /dev /console. 

An ioctl TIOCCONS may be applied to serial devices other than the console to cause output 
which would normal^ appear on the console to instead be routed to the other devices. This is 
used by the window system which does a TIOCCONS on a pseudo-terminal to cause console out- 
put to be routed there rather than to the screen through the PROM monitor, since routing output 
through the PROM destroys the integrity of the screen. 

FILES 

/dev/consoi'e 

/dev/ttya alternate console (serial port) 

SEE ALSO 

oct(4S), t^(4), Z8(4S) 

BUGS 

TIOCCONS should be restricted to the owner of /dev/console. 
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SPECIAL FILES 



DKI0(4S) 



NAME 

dkio - generic disk control operations 

DESCRIPTION 

All Sun disk drivers support a set of ioctl's for disk formattting and labelling iterations, 
these ioctl's are the definitions in <sun/dkia.h>: 

/* 
* Structures and definitions for disk io control commands 

V 



Basic to 



/* Disk identification */ 
struct dk Jnfo { 



int 
short 
short 
short 



dki_ctlr; 
dki_unit; 
dkijctype;^ 
dki^flags; 



/* controller types •/ 

#define DKC JONKNO WN 

#define DKC_SMD2180 

#defineDKC_XY440 

#defineDKC_DSD5215 

#defineDKC_XY450 

#defineDKC_SCSI 

/* flags */ 

#defineDKIJBADl44 01 
#define DKI_MAPTRK 02 
#defineDKI_FMTTRK 04 
#defineDKLFMTVOL 0x08 



/* controller address */ 
I* unit (slave) address */ 
/* controller type */ 
/* flags */ 



/* use DEC std 144 bad sector fwding */ 
/* controller does track mapping */ 
/* formats only full track at a time */ 
/* formats only full volume at a time *l 



I* Definition of a disk's 

struct dk_geom { 

unsigned short 
unsigned short 
unsigned short 
unsigned short 
unsigned short 
unsigned short 
unsigned short 
unsigned short 
unsigned short 
unsigned short 



geometry */ 

dkg_ncyl; 

dkg_acyl; 

dkg_bcyl; 

dkg_nhead; 

dkg^bhead; 

dkg_nsect; 

dkgjntrlv; 

dkg_gapl; 

dkg_gap2; 

dkgjextrajlO}; 



/* Disk format request */ 
struct dk_fmt { 

daddr_tdkf_blkno; 

daddrjdkf.nblk; 

u char dkf.fill; 

}; 

/* Disk re-map request */ 



/* # of data cylinders */ 

/* # of alternate cylinders */ 

/* cyl offset (for fixed head area) */ 

/♦ # of heads ♦/ 

/* head offset (for Larks, etc.) */ 

/* # of sectors per track */ 

/* interleave factor */ 

/* gap 1 sire */ 

/* gap 2 size */ 

/* for compatible expansion */ 



/* starting block */ 
/* # of blocks */ 
/* fill data */ 



10 
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struct dk.mapr { 

daddr_tdkm_fblk; /* from block */ 

daddr_tdkm_tblk; /♦ to block */ 

daddr_tdkm_nblk; /*# blocks */ 

u_char dkm^fiU; /* fill data */ 

}; 

/* disk io control commands */ 

#define DKIOCHDR _IO(d, 1) /* next I/O will read/write header */ 

#defineDKIOCGGEOM _IOR(d, 2, struct dk_geom) /♦ Get geometry */ 

#defineDKIOCSGEOM _IOW(d, 3, struct dk^eom) /* Set geometry */ 

#defineDKIOCGPART _IOR(d, 4, struct dk.map) /* Get partition info */ 

#define DKIOCSPART JO W(d, 5, struct dk„map) /♦ Set partition info */ 

#defineDKIOCFMT JOW(d, 6, struct dkjmt) /* Format */ 

#defineDKIOCMAP _IOW(d, 7, struct dk_mapr) /* Map ♦/ 

#defineDKIOCINFO _IOR(d, 8, struct dkjnfo) /* Get info ♦/ 

The DKIOCGINFO ioctl returns a dkjinfo structure which tells the kind of the controller and 
attributes about how bad-block processing is done on the controller. Bad sectors can then be pro- 
cessed using either the DKIOCMAP request, which causes a sector to be re-mapped on the disk, 
or the DKIOCFNO* request which causes a sector to be re-formatted. To read or write the header 
on a disk sector the DKIOCHDR ioctl can be used, it causes the next read or write request to also 
read or write the (drive-type-specific) header data. 

The DKIOCGPART and DKIOCSPART get and set the controller's current notion of the parti- 
tion table for the disk (without changing the partition table on the disk itself), while the 
DKIOCGGEOM and DKIOCSGEOM ioctl's do similar things for the per-drive geometry informa- 
tion. These can be used to format a drive, where the label does not exist before the drive is for- 
matted. 

SEE ALSO 

ip(4S), xy(4S) 

BUGS 

The DKIOCMAP and DKIOCFMT request are incompletely implemented. 
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NAME 

drum - paging device 

SYNOPSIS 

None; included with standard system. 

DESCRIPTION 

This file refers to the paging device in use by the system. This may actually be a subdevice of 
one of the disk drivers, but in a system with paging interleaved across multiple disk drives it pro- 
vides an indirect driver for the multiple drives. 



FILES 
BUGS 



/dev/drum 

Reads from the drum are not allowed across the interleaving boundaries. Since these only occur 
every .SMbytes or so, and since the system never allocates blocks across the boundary, this is usu- 
ally not a problem. 
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NAM£ 

ee - 3Com 10 Mb/s Ethernet interface 

SYNOPSIS 

device ecO at mbO esr OxeOOOO priority 3 

DESCRIPTION 

The ec interface provides access to a 10 Mb/s Ethernet network through a 3COM controller. For 
a general description of network interfaces see ty(4N). 

The hardware consumes 8 kilobytes of Multibus memory space. This memory is used for internal 
buffering by the board. The board starts at standard addresses OxEX)000 or OxE2000. The board 
must be configured for interrupt level 3. 

The interface software implements an exponential backoff algorithm when notified of a collision 
on the cable. 

The interface handles the Internet protocol family, with the interface address maintained in Inter- 
net format. The Address Resolution Protocol arp(4P) is used to map 32-bit Internet addresses 
used in mel(4F) to the 48-bit addresses used on the Ethernet. 

DIAGNOSTICS 

ee%d; Ethernet Jammed. After 16 failed transmissions and backoffs using the exponential 
backoff algorithm, the packet was dropped. 

ee%di can*t handle af%d. The interface was handed a message with addresses formatted in an 
unsuitable address family; the packet was dropped. 

SEE ALSO 

arp(4N), if(4N), inet(4F) 

3COM 3C400 Multibus Ethernet Controller Reference Manual (Sun 800-0398) 

BUGS 

The interface hardware is not capable of talking to itself, making diagnosis more difficult. 
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NAME 

en - Sun 3 \fb/s experimental Ethernet interface 

SYNOPSIS 

device enO at mbO csr 0x100 priority 3 

DESCRIPTION 

The en interface provides access to a 3 Mb/s Ethernet network. The host's address^is ducovered 
at boot time by probing the Ethernet address register. For a general description of network ihtep* 
faces, sec i7(4N). 

The board consumes 256 bytes of Multibus I/O space starting at standard address QxlOO. 

The interface handles both Internet and PUP protocol families, with the interface address main- 
tained in Internet format. PUP addresses are converted to Internet addresses by subsituUng PUP 
network and host values for Internet network and imp values, and setting the Internet host 
number to zero. 

DIAGNOSTICS 

en%di output error. The hardware indicated an error on the previous transmission.. 

en%dz send^ error. After 16 retransmissions the packet was dropped. 

en%d: Input error. The hardware indicated an error in reading a packet off the cable. 

en%dt can^t handle af%d. The interface was handed a message with addresses formatted in 
an unsuitable address family; the packet was dropped. 

SEE ALSO 

if (4N), inet(4F) 

Sun 3Mbit Ethernet Board, User's. ManuaT (Sun 800^0392) 

BUGS 

This hardware and driver are not supported. 
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NAME 

fb - driver for Sun console frame buffer 

SYNOPSIS 

None; included in standard system. 

DESCRIPTION 

The fh driver provides indirect access to a Sun graphics controller board. It is an indirect driver 
for the Sun workstation console's frame buffer. At boot time, the workstation's frame buffer dev- 
ice is determined from information from the Monitor Proms and set to be the one that fb will 
indirect to. The device driver for the console's frame buffer must be configured into the kernel so 
that this indirect driver can access it. 

The idea behind this driver is that user programs can open a known device, query its characteris- 
tics and access it in a device dependent way, depending on the type. Fb redirects open(2), 
c/0«e(2), tocf/(2), and mmap{2) calls to the real frame buffer. All of the Sun frame buffers support 
the same general interface; see fbio{AS) 

FILES 

SEE ALSO 

fbiQ(4S), bwone(4S), bwtwo(4S) 
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NAME 

fbio - general properties of frame buflfers 

DESCRIPTION 

All of the Sun frame buffers support the same general interface. Each responds to a FBIOGTYPE 
iocti{2} -which returns information in a structure defined in <8un/fbio.h>: 



struct fbt;pe { 



}: 



int 


fb_<ype; 


ittt 


fb^height; 


int 


fbjwidth; 


int 


fb^dcptht 


int 


fb_cmsite; 


int 


fb^siie; 



/* as defined below */ 

/* in pbceb ♦/ 

/* in pixeb */ 

/* bits per p&cei*/ 

/* size of color map (entries) */ 

/* total size in by^tes */^ 



#deflneFBTSfPE_SUNlBW & 

#dcfineFBTYPE_SUNlCOLOR 1 

#defineFBTYPE_Sl^2BW^ 2 

Each device has a FBTYPE which is used by higher-level software to determine how to perform 
raster-op and other functions. Each device is used by opening it, doing a FBIOGTYPE toctl to 
see which frame buffer type is present^ and thereby selecting the appropriate device management 
routines. 

Full fledged frame buffers, i.e., those that expect to run SunWindows, implement an FBIOGPDC- 
RECT ioctl{2), which returns a pixrect. This call is made only from inside the kernel. The 
returned pixrect is used by win(4S) for cursor tracking and colormap loading. 

SEE ALSO 

mmap(2), fb(4S), bwone(4S), bwtwo(4S), cgone(4S), win(4S) 
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SPECIAL FILES 



ICMP(4P) 



NAME 

icmp - Internet Control Message Protocol 

SYNOPSIS 

None; included automatically with tne{(4F). 

DESCRIPTION 

The Internet Control Message Protocol ICMP is used by gateways and destination hosts which 
process datagrams to communicate errors in datagram processing to source hosts. (The datagram 
level of Internet is discussed in tp(4P).) ICMP uses the basic support of IP as if it were a higher 
level protocol, however ICMP is actually an integral part of IP. 

ICMP messages are sent in several situations: for example when a datagram, cannot reach its des- 
tination, when the gateway does not have the buffering capacity to forward a datagram, and when 
the gateway can direct the host to send trafRc on a shorter route. 

The Internet protocol is not designed to be absolutely reliable. The purpose of these control mes- 
sages is to provide feedback about problems in the communication environment, not to make IP 
reliable. There are still no guarantees that a datagram will be delivered or a control message will 
be returned. Some datagrams may still be undelivered without any report of their loss. The 
higher level protocok which use IP must implement their own reliability procedures if reliable 
communication is required. 

The ICMP messages typically report errors in the processing of datagrams. To avoid the infinite 
regress of messages about messages etc., no ICMP messages are sent about ICMP messages. Also 
ICMP messages are only sent about errors in handling fragment of fragmented datagrams. 

There are il types of ICMP packets which can be received by the system. They are defined in 
thu excerpt from <netinet/ip_icmp.h>, which also defines the values of some additional codes 
further specifying the cause of certain errors. 



* Definition of type and code field values 

♦/ 
#deflne ICMP.ECHGREPL Y 

#defineICMPJUNREACH 3 

#define ICMP_UNREACH_NET 

#define ICMP_UNREACH_HOST 

#dcflne ICMP^UNREACH.PROTGCOL 

#define ICMP^UNREACHJPORT 

#define ICMP_UNREACH NEEDFRAG 

#define ICMP^UNREACH^SRCFAIL 

#define ICMP_SGURCEQUENCH 4 

#dcfineICMPJlEDIRECT 5 

#define ICMP_REDIRECT_NET 

#define ICMPJIEDIRECTJIGST 

#define ICMP_REDIRECT_TGSNET 

#define ICMP_REDIRECT_TGSHGST 

#define ICMP_ECHG 8 

#defineICMP_TIMXCEED 11 

#define ICMP_TIMXCEED_INTRANS 

#define ICMP_TIMXCEED_REASS 

#define ICMP.PARAMPROB 12 

#define ICMP^TSTAMP 13 

#define ICMP_TSTAMPREPLY 14 

#defineICMP_IREQ 15 

#defineICMP_IREQREPLY 16 



/* echo reply */ 

/* dest unreachable, codes: */ 

/* bad net */ 

1 /* bad host */ 

2 /* bad protocol */ 

3 /* bad port */ 

4 /* IP_DF caused drop */ 
6 /* src route failed */ 
/* packet lost, slow down */ 
/* shorter route, codes: */ 

/* for network */ 

1 /* for host */ 

2 /* for tos and net */ 

3 /* for tos and host */ 
/* echo service */ 
/* time exceeded, code: */ 

/♦ ttl==0 in transit */ 

1 /* ttl==0 in reass */ 
/* ip header bad */ 
/* timestamp request */ 
/* timestamp reply */ 
/* information request */ 
/* information reply */ 
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Arriving ECHO and TSTAMP packets cause the system to generate ECHOREPLY and 
TSTAMPREPLY packets. IREQ packets are not yet processed by the system, and are discarded. 
UNREACH, SOURCEQUENCH, TIMXCEED and PARAMPROB packets are processed inter- 
nally by the protocols implemented in the system, or reflected to the user if a raw socket is being 
used; see tp(4P). REDIRECT, ECHOREPLY, TSTAMPREPLY and IREQREPLY are also 
reflected to users of raw sockets. In addition, REDIRECT messages cause the kernel routing 
tables to be updated; see routing(AN). 

SEE ALSO 

inet(4F), ip(4P) 

Internet Control Message Protocol, RFC792, J. Postel, USC-ISI (Sun 800-1064-01) 

BUGS 

IREQ messages are not processed properly: the address fields are not set. 

Messages which are source routed are not sent back using inverted source routes, but rather go 
back through the normal routing mechanisms. 
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NAME 

if - general propertiea of network interfaces 

DESCRIPTION 

Each network interface in a system corresponds to a path through which messages may be sent 
and received. A network interface usually has a hardware device associated with it, though cer- 
tain interfaces such as the loopback interface, lo{4), do not. 

At boot time each interface which has underlying hardware support makes itself known to the 
system during the autoconfiguration process. Once the interface has acquired its address it is 
expected to install a routing table entry so that messages may be routed through it. Most inter- 
faces require sdme part of their address specified with an SIOCSIFADDR ioctl before they will 
allow traffic to flow through them. On interfaces where the network-link layer address mapping is 
static, only the network number is taken from the ioctl; the remainder is found in a hardware 
specific manner. On interfaces which provide dynamic network-link layer address mapping facili- 
ties (e.g. lOMb/s Ethernets using arp(4P),), the entire address specified in the ioctl is used. 

The following ioctl calls may be used to manipulate network interfaces. Unless specified other- 
wise, the request takes an t/re^ structure as its paraoneter. This structure has the form 

struct ifreq { 

char ifr_name|16]; /* name of in^rcrface (eg. "ecO") */ 

union { 

struct sockaddr ifru_addr; 

struct sockaddr ifrujdstaddr; 

short ifru_fiags; 
} ifr Jfru; 

#define ifr^addr ifrjfru.ifru_addr /* address */ 

#define ifr_dstaddr if rjfru. ifrujdstaddr /* other end of p-to-p link */ 

#de&ne ifrJBags ifrJfru.ifruJSags /* flags */ 

y> 

SIOCSFADDR 

Set interface address. Following the address assignment, the "initialization" routine for 
the interface ia called. 

SIOCGIFADDR 

Get interface address. 

SIOCSIFDSTADDR 

Set point to point address for interface. 

SIOCGIFDSTADDR 

Get point to point address for interface. 

SIOCSIFrLAGS 

Set interface flags field. If the interface is marked down, any processes currently routing 
packets through the interface are notified. 

SIOCGIFFLAGS 

Get interface fla^. 

SIOCGn!'CONF 

Get interface configuration list. This request takes an ifconf structure (see below) as a 
value-result parameter. The ifcjlen field should be initially set to the size of the buffer 
pointed to by ifcjbuf. On return it will contain the length, in bytes, of the configuration 
list. 

/♦ 

* Structure used in SIOCGIFCONF request. 

* Used to retrieve interface configuration 



Sun Release 1.1 Last change: 15 August 1983 19 



IF(4N) SPECIAL FILES IF(4N) 



* for machine (useful for programs which 

* must know all networks accessible). 

V 

struct ifconf { 

int ifc Jen; /* size of associated buffer */ 

union { 

caddr_t ifcu_buf; 
struct ifreq *ifcu_req; 
} ifc_ifcu; 
#define ifc_buf ifc_ifcu.ifcu_buf /* buffer address */ 
#define ifc_req ifc_ifcu.ifcu req /* array of structures returned */ 

}; 

SEE ALSO 

arp(4P), ec(4S), en(4S), lo(4) 
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NAME 

inet - Internet protocol family 

SYNOPSIS 

options INET 
pseudo-device Inet 

DESCRIPTION 

The Internet protocol family b a collection of protocok layered atop the Internet Protocol (IP) 
transport layer, and ntilizing the Internet address format. The Internet family provides protocol 
support for the SOCK_STREAM, SOCKJDGRAM, and SOCK_RAW socket types; the 
SOCK_RAW interface provides access to the IP protocol. 

ADDRESSING 

Internet addresses are four byte quantities, stored in network standard format (on the VAX these 
are word and byte reversed). The include file <netinet/in.h> defines this address as a discrim- 
inated union. 

Sockets in the Internet protocol family utilize the following addressing structure, 

struct 8iM;kaddr_in { 

short sinjfamily; 
u jshort 8in_port; 
struct in_addr sin_addr; 
char 8in.zero|8]; 

}: 

(Libraiy routines to return and manipulate structures of this form are in section 3N of the 
manual; see intro{SN) and the other section 3 entries mentioned under SEE ALSO below.) Each 
socket has a local address specifiable in this form, which can be established with bind{2); the get- 
8eckname{2) call returns this address. Each socket also may be bound to a peer socket with an 
address specified in this form; this peer address can be specified in a connect{2) call, or transiently 
with a single message in a eendto or eendmsg call; see 8end{2). The peer address of a socket is 
returned by the getpeername{2) call. 

The sin^addr field of the socket addre»» specifies the Internet address of the machine on which the 
socket is located. A special value may be specified or returned for this field, 
sin_addr.s„addrsas=INADDR_ANY. This address is a "wildcard" and matches any of the legal 
internet addresses on the local machine. This address is useful when a process neither knows (nor 
cares) what the local Internet address b, but even more useful for server processes with which to 
service all requests to. the current machine. Since a machine can have several addresses (one per 
hardware network interface), specifying a single address would restrict access to the service to 
those clients which specified the address of that interface. By specifying INADDR_ANY, the 
server can arrange to service clients from all interfaces. 

When a socket address is bound, the networking system checks that there is an interface with the 
address specified available on the current machine (unless, of course, a wildcard address is 
specified), and returns an error EADDRNOTAVAIL if no such interface is found. 

The local port address specified in a bind{2) cd\\ is restricted to be greater than 
IPPORT_RESERVED (=1024, in <netinet/in.h>) unless the creating process is running as the 
super-user, providing a space of protected port numbers. The local port address is also required 
to not be in use in order for it to be assigned. This is checked by looking for another socket of 
the same type which has the same local address and local port number. If such a socket already 
exists, you wiU not be able to create another socket at the same address, and will instead get the 
error EADDRINUSE. If the local port address is specified as 0, then the system picks a unique 
port address not less t^an IPPORTJRESERVED and assigns it to the port. A unique local port 
ad^jpess is also picked for a socket which is not bound but which b used with connect{2) or 
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8endto{2); this allows tcp{4p) connections to be made by simpfy doing 8ocket{2) and then eon- 
nect{2) in the case where the local port address is not significant; it is defaulted by the system. 
Similarly if you are sending datagrams with udp{4P) and do not care which port they come from, 
you can just do 80cket{2) and 8endto{2) and let the system pick a port number. 

Let us say that two sockets are incompatible if they have the same port number, are not conected 
to other sockets, and do not have different local host addresses. (It is possible to have two sockets 
with the same port number and different local host addresses because a machine may have several 
local addresses from its different network interfaces.) The Internet system does not allow such 
incompatible sockets to exist on a single machine. Consider a socket which has a specific local 
host and local port number on the current machine. If another process tries to create a socket 
with a wildcard local host address and the same port number then that request will be denied. 
For connection based sockets this prevents these two sockets from attempting to connect to the 
same foreign host/socket, and thereby causing great havoc. For connectionless sockets this 
prevents the dilemma which would result from trying to determine who to deliver an incoming 
datagram to (since more than one socket could match an address given on a datagram). The 
same restriction applies if the wildcard socket exists first. (If both sockets are wildcard, then the 
normal restrictions on duplicate addresses apply.) 

A socket option SO_REUSEADDR exists to allow incompatible sockets to be created. This 
option is needed to implement the File Transfer Protocol (FTP) which requires that a connection 
be made from an existing port number (the port number of its primary connection) to a different 
port number on the same remote host. The danger here is that the user would attempt to con- 
nect this second port to the same remote host/port that the primary connection was using. In 
using SO_REUSEADDR the user is pledging not to do this, since this will cause the first connec- 
tion to abort. 

When a connect{2) is done, the Internet system first checks that the socket is not already con- 
nected. If does not allow connections to port number on another host, nor does it allow connec- 
tions to a wildcard host (8in_addr.s_addr==INADDR_ANY); attempts to do this yield EAD- 
DRINUSE. If the socket from which the connection is being made currently has a wildcard local 
address (either because it was bound to a specific port with a wildcard address, or was never sub- 
jected to bind{2)), then the system picks a local Internet address for the socket from the set of 
addresses of interfaces on the local machine. If there is an interface on the local machine on the 
same network as the machine being connected to, then that address is used. Otherwise, the 
"first" local network interface is used (this is the one that prints out first in "netstat -i"; see 
net8tat{S)). Although it is not supposed to matter which interface address is used, in practice it 
would probably be better to select the address of the interface through which the packets are to 
be routed. This is not currently done (as it would involve a fair amount of additional overhead 
for datagram transmission). 

PROTOCOLS 

The Internet protocol family supported by the operating system is comprised of the Internet 
Datagram Protocol (IP) ip{4P), Address Resolution Protocol (ARP) crp(4P), Internet Control 
Message Protocol (ICMP) icmp{4P), Transmission Control Protocol (TCP) tcp{4P), and User 
Datagram Protocol (UDP) udp{4P). 

TCP is used to support the SOCK_STREAM abstraction while UDP is used to support the 
SOCK_DGRAM abstraction. A raw interface to IP is available by creating an Internet socket of 
type SOCKJRAW; see »p(4P). The ICMP message protocol is not directly accessible, and is used 
by the system to handle and report errors in protocol processing. The ARP protocol is used to 
translate 32~bit Internet host numbers into the 48 bit addresses needed for an Ethernet. 

SEE ALSO 

intro(3N), byteorder(3N), gethostent(3N), getnetent(3N), getprotoent(3N), getservent(3N), 

inet(3N), network(3N), arp(4P), tcp(4P), udp(4P), ip(4P) 

Internet Protocol Transition Workbook, Network Information Center, SRI (Sun 800-1056-01) 
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Internet Protocol Implementation Guide, Network Information Center, SRI (Sun 800-1055-01) 
A 4.2BSD Interprocess Communication Primer 
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NAME 

ip - Internet Protocol 

SYNOPSIS 

None; included by default with inet{4F). 

DESCRIPTION 

The Internet Protocol is designed for use in interconnected ^sterns of packet-switched computer 
communication networks. It provides for transmitting blocks of data called datagrams from 
sources to destinations, where sources and destinations are hosts identified by fixed length 
addresses. It also provides for fragmentation and reassembly of long datagrams, if necessary, for 
transmission through "small packet" networks. 

IP is specifically limited in scope. There are no mechanisms to augment end-to-end data reliabil- 
ity, flow control, sequencing, or other services commonly found in host-to-host protocols. IP can 
capitalize on the services of its supporting networks to provide various types and qualities of ser- 
vice. 

IP is called on by host-to-host protocols, including fcp(4P) a reliable stream protocol, udp{4F) a 
socket-socket datagram protocol, and ni(4P) the network disk protocol. Other protocols may be 
layered on top of IP using the raw protocol facilities described here to receive and send datagrams 
with a specific EP protocol number. The IP protocol calls on local network drivers to carry the 
internet datagram to the next gateway or destination host. 

When a datagram arrives at a UNIX host, the system performs a checksum on the header of the 
datagram. If this fails, or if the datagram is unreasonably short or the header length specified in 
the datagram is not within range, then the datagram is dropped. (Checksumming of Internet 
datagrams may be disabled for debugging purposes by patching the kernel variable ipcksum to 
have the value 0.) 

Next the system scans the IP options of the datagram. Options allowing for source routing (see 
routing{4N)) and also the collection of time stamps as a packet follows a particular route (for net- 
work monitoring and statistics gathering purposes) are handled; other options are ignored. Pro- 
cessing of source routing options may result in an UNREACH temp (4P) message because the 
source routed host is not accessible. 

After processing the options, IP checks to see if the current machine is the destination for the 
datagram. If not, then IP attempts to forward the datagram to the proper host. Before forward- 
ing the datagram, IP decrements the time to live field of the datagram by IPTTLDEC seconds 
(currently 5 from <netinet/ip.h>), and discards the datagram if its lifetime has expired, sending 
an ICMP TIMXCEED error packet back to the source host. Similarly if the attempt to forward 
the datagram fails, then ICMP messages indicating an unreachable network, datagram too large, 
unreachable port (datagram would have required broadcasting on the target interface, and IP does 
not allow directed broadcasts), lack of buffer space (refiected as a source quench), or unreachable 
host. Note however, in accordance with the ICMP protocol specification, ICMP messages are 
returned only for the first fragment of fragmented datagrams. 

It is possible to disable the forwarding of datagrams by a host by patching the kernel variable 
ipforwarding to have value 0. 

If a packet arrives and is destined for this machine, then IP must check to see if other fragments 
of the same datagram are being held. If this datagram is complete, then any previous fragments 
of thb datagram are discarded. If this is only a fragment of a datagram, it may yield a complete 
set of pieces for the datagram, in which case IP constructs the complete datagram and continues 
processing with that. If there is yet no complete set of pieces for this datagram then we hold onto 
as fnuch data as we have received (but only one copy of each data byte from the datagram) in 
hopes that the rest of the pieces of the fragmented datagram will arrive and we will be able to 
proceed. We allow IPFRAGTTL (currently 15 in <netinet/ip.h>) seconds for all the fragments 
of a datagram to arrive, and discard partial fragments then if the datagram has not yet been 
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completely assembled. 

When we have a complete input datagram it is passed out to the appropriate protocol's input rou- 
tine: either tcp{4F), udp(iF), nrf(4P), tcmp(4P) or a user process through a raw IP socket as 
described below. 

Datagrams are output by the system implemented protocols tcp{4P), udp{4P), nd{4P), and 
icmp{4P) as well as by packet forwarding operations and user processes through raw IP sockets. 
Output packets are normally subjected to routing as described in routing{4N); special processes 
such as the routing daemon routed{SC) occasionally use the SO_J)ONTROUTE socket option to 
cause the packets to avoid the routing tables and go directly to the network interface which has 
the same network number as the packet is addressed to. This is used to be able to test the ability 
of the hardware to transmit and receive packets even when we believe that the hardware is bro- 
ken and have therefore deleted it from the routing tables. 

If there is no route to a destination address or if the SOJDONTROUTE option is given and there 
is no interface on the network specified by the destination address, then the IP output routine 
returns a ENETUNREACH error. (This and the other IP output errors are reflected back to user 
processes through the various protocols, which individually describe how errors are reported.) 

In the (hopefully normal) case where there is a suitable route or network interface, the destination 
address is checked to see if it specifies a broadcast (address INADDR_ANY; see inet{4F)); if it 
does, and the hardware interface does not support broadcasts, then an EADDRNOTAVAIL is 
returned; if the caller is not the super-user then a EACCESS error will be returned. IP also does 
not allow broadcast messages to be fragmented, returning a EMSGSIZE error in this case. 

If the datagram passes all these tests, and is small enough to be sent in one chunk, then the sys- 
tem calls the output routine for the particular hardware interface to transmit the packet. The 
interface may give an error indication, which is reflected to IP output's caller; see the various 
interface's documentation for a description of the errors which they may encounter. If a 
datagram is to be fragmented, it may have the IP_DF (don't fragment) flag set (although 
currently this can happen only for forwarded datagrams). If it does, then the datagram will be 
rejected (and result in an ICMP error datagram). If the system runs out of buffer space in frag- 
menting a datagram then a ENOBUFS error will be returned. 

IP provides a space of 255 protocols. The known protocols are defined in <netinet/in.h>. The 
ICMP, TCP, UDP and ND protocob are processed internally by the system; others may be 
accessed through a raw socket by doing: 

8 = BocketCAFJNET, SOCK.RAW, IPPROTO_xxx)j 

Datagrams sent from this socket will have the current host's address and the specified protocol 
number; the raw IP driver will construct an appropriate header. When IP datagrams are received 
for this protocol they are queued on the raw socket where they may be read with recvfrom; the 
source IP address is reflected in the received address. 

SEE ALSO 

8end(2), recv(2), inet(4F) 

Internet Protocol, RFC791, USC-iSI (Sun 800-1063-01) 



BUGS 



One should be able to send and receive IP options. 

Raw sockets should receive ICMP error packets relating to the protocol; currently such packets 
are simply discarded. 
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NAME 

ip - Disk driver for Interphase 2180 SMD Disk Controller 

SYNOPSIS 

controller ipcO at mbO car 0x40 priority 2 
dbic ipO at ipcO drive 
dislc ipl at ipcO drive 1 

DESCRIPTION 

Files with minor device numbers through 7 refer to various portions of drive 0; minor devices 8 
through 15 refer to drive 1, and so on. The standard device names begin with "ip" followed by 
the drive number and then a letter a-h for partitions 0-7 respectively. The character ? stands 
here for a drive number in the range 0-7. 

The block file's access the disk via the system's normal buffering mechanism and may be read and 
written without regard to physical disk records. There is also a 'raw' interface which provides for 
direct transmission between the disk and the user's read or write buffer. A single read or write 
call results in exactly one I/O operation and therefore raw I/O is considerably more effficient 
when many words are transmitted. The names of the raw files conventionally begin with an extra 

In raw I/O counts should be a multiple of 512 bytes (a disk sector). Likewise eeek calls should 
specify a multiple of 512 bytes. 

DISK SUPPORT 

This driver handles all SMD drives, by reading a label from sector of the drive which describes 
the disk geometry and partitioning. 

The ip?a partition is normally used for the root file system on a disk, the ip?b partition as a pag- 
ing area, and the ip?c partition for pack-pack copying (it normally maps the entire disk). The 
rest of the disk is normally the ip?h partition. 



FILES 



/dev/ip(0-7lla-hl block files 

/dev/rip|0-7](a-h] raw files 



SEE ALSO 

dkio(4S), xy(4S) 

"Interphase SMD2180 Storage Module Controller/Formatter - User's Guide" (Sun 800-0274) 

DIAGNOSTICS 

ip%d: SMD-2180. When booting tells the controller type. 

ip%dt initialization failed. Because the controller didn't respond; perhaps another device is at 
the address the system expected an Interphase controller at. 

ip%dt error %x reading label on liead %d. Error reading drive geometry /partition table 
information. 

ip%d: Corrupt label on liead %d. The geometry /partition label checksum was incorrect. 

ip%dt Misplaced label on head %d. A disk label was copied to the wrong head on the disk; 
shoudn't happen. 

ip%ds Unsupported pliys partition # %d. This indicates a bad label. 

ip%d: unit not online. 

ip%d%c: cmd how (msg) blk %d. A command such as read, write, or format encountered a 
error condition (how): either it failed, the unit was restored, or an operation was rctry'cd. The 
mag is derived from the error number given by the controller, indicating a condition such as 
"drive not ready", "sector not found" or "disk write protected". 
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BUGS 

In raw I/O read and write{2) truncate file offsets to 512-byte block boundaries, and write scribbles 
on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, read, 
write and l8eek{2) should always deal in 512-byte multiples. 

The driver no longer supports versions of the 2181. 
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NAME 

kb - Sun keyboard 

SYNOPSIS 

pseudo-device kb3 

DESCRIPTION 

Kb provides access to the Sun workstation keyboard translation. Definitions for alterring key- 
board translation are in <sundev/kbio.h> and <sundev/kbd.li>. 

The call KIOCTRANS controls the presence of keyboard translation: 

int x; 

err « ioctl(fd, KIOCTRANS, &x); 

where if z is the keyboard tranlation is turned off and up/down key codes are reported. Speci- 
fying X as 1 restores normal keyboard translations. 

The call KIOCSETKEY changes a keyboard translation table entry: 

struct kiockey { 

int kio.tablemask; /* Translation table (one of: 0, CAPSMASK, 

SHIFTMASK, CTRLMASK, UPMASK) */ 
u_char kio_station; /* Physical keyboard key station (0-127) */ 
u„char kio_entry; /* Translation table station's entry */ 

char kio 8tring[10|; /* Value for STRING entries (null terminated) */ 

}; 

struct kiockey key; 

err « ioctl(fd, KIOCSETKEY, &key); 

Set kiojtablemask table's kio^station to kio_entry. Copy kio_jtring to string table if kio__entry is 
between STRING and STRING+ 15. This call may return EINVAL if there are invalid argu- 
ments. 

The call KIOCGETKEY determines the current value of a keyboard translation table entry: 

struct kiockey key; 

err « ioctl(fd, KIOCGETKEY, &key); 

Get kiojtablemask table's kio_8tation to kio_entry. Get kio_8tring from string table if kio_entry is 
between STRING and STRING+ 15. This call may return EINVAL if there are invalid argu- 
ments. 

FILES 

/dev/kbd 

SEE ALSO 

kbd(5) 
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NAME 

lo - software loopback network interface 

SYNOPSIS 

pseudo-deviee loop 

DESCRIPTION 

The loop device is a software loopback network interface; see ty(4N) for a general description of 
network interfaces. 

The loop interface is used for performance analysis and software testing, and to provide 
guaranteed access to Internet protocols on machines with no local network interfaces. A typical 
application is the eom9at{8C) server which accepts notification of mail delivery through a particu- 
lar port on the loopback interface. 

By default, the loopback interface is accessible at Internet address 127.0.0.1 (non-standard); this 
address may be changed with the SIOCSIFADDR ioctl. 

DIAGNOSTICS 

lo%di ean*t handle mt%d. The interface was handed a message with addresses formatted in an 
unsuitable address family; the packet was dropped. 

SEE ALSO 

if(4N), inet(4F) 

BUGS 

It should handle all address and protocol families. An approved network address should be 
reserved for this interface. 
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NAME 

mb - Multibus 

SYNOPSIS 

controller mbO at nexus f 

DESCRIPTION 

The mb device is the driver for the Intel MuItibus(R), which provides support functions to the 
various devices w^hich can reside there. It vectors interrupts to the Multibus devices according to 
the priority level of the interrupt received and queues requests for dma when there are insufficient 
resources to service the request or to allow certain dma's to proceed exclusively. It also imple- 
ments byte swapping to/from deficient devices. 

DIAGNOSTICS 
None. 

SEE ALSO 

ar(4S), cg(4S), ip(4S), m8(4S), oct(4S), tm(4S), vp(4S), xy(4S), zs(4S) 

Intel Multibu8(R) Specification, Order Number 9800683-04 (Sun 800-1057-01) 
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NAME 

mem, kmem, mbmem, mbio - main memory and I/O space 

SYNOPSIS 

None; included with standard system. 

DESCRIPTION 

These devices are special files that map memory and bus i/o space. They may be read, written, 
seek'ed and (except for kmem) mmap(2)ed. 

Mem is a special file that is an image of the physical memory of the computer. It may be used, 
for example, to examine (and even to patch) the system. 

Kmem is a special file that is an image of the kernel virtual memory of the system. 

Mbmem is a special file that is an image of the Multibus memory of the system. Multibus 
memory is in the range from to 1 Megabyte. 

Mbio is a special file that is an image of the Multibus I/O space. Multibus I/O space extends 
from0to64K. 

When reading and writing mbmem and mbio odd counts or offsets cause byte accesses and even 
counts and offsets cause word accesses. 

DIAGNOSTICS 

None. 

FILES 

/dev/mem 
/dev/kmem 
/dcv/mbmem 
/dev/mbio 
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NAME 

mouse - Sun mouse 

SYNOPSIS 

pseudo-device msS 

DESCRIPTION 

The mouse interface provides access to the Sun Workstation mouse. 

The mouse incorporates a microprocessor which generates a byte-stream protocol encoding mouse 
motions. 

Each mouse sample in the byte stream consists of three bytes: the first byte gives the button state 
with value OxS7\''but, where but is the low three bits giving the mouse buttons, where a (zero) 
bit means that a button is pressed, and a 1 (one) bit means a button is not pressed. Thus if the 
left button is down the value of this sample is 0x83, while if the right button is down the byte is 
0x86. 

The next two bytes of each sample give the x and jf delta^s of this sample as signed bytes. The 
mouse uses a lower-left coordinate system, so moves to the right on the screen yield positive x 
values and moves down the screen yield negative y values. 

The beginning of a sample is identifiable because the delta's are constrained to not have values in 
the range 0x80-0x87. 

FILES 

/dev/mouse 

SEE ALSO 

win(4S)^ 

Mouse System Mouse Manual (Sun 800-0419) 

User's Guide for the Sun Workstation Mouse Subsystem (Sun 800-0402) 
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NAME 

mti - Systech MTI-800/1600 multi-terminal interface 

SYNOPSIS 

device mtiO at mbO car 0x620 flags OxfTflT priority 4 

DESCRIPTION 

The Systech MTI card provides 8 (MTI-800) or 16 (MTI-1600) serial communication lines with 
modem control. Each line behaves as described in tty{4). Input and output for each line may 
independently be set to run at any of 16 speeds; see tty{4) for the encoding. 

Bit ( of flags may be specified to say that a line is not properly connected, and that the line i 
should be treated as hard-wired with carrier always present. Thus specifying "flags 0x0004" in 
the specification of mtiO would cause line tty02 to be treated in this way. 

To allow a single tty line to be connected to a modem and used for both incoming and outgoing 
calls, a special feature, controlled by the minor device number, has been added. Minor device 
numbers in the range - 127 correspond directly to the normal tty lines and are named tt]/". 
Minor device numbers in the range 128 - 256 correspond to the same physical lines as those above 
(i.e. the same line as the minor device number minus 128) and are (conventionally) named cna*. 
The cua lines are special in that they can be opened even when there b no carrier on the line. 
Once a cua line is opened, the corresponding tty line can not be opened until the cua line is 
closed. Also, if the tty line has been opened successfully (usually only when carrier is recognized 
on the modem) the corresponding cua line can not be opened. This allows a modem to be 
attached to /dev/ttyOO (usually renamed to /dev/ttydO) and used for dialin (be enabling the line 
for login in /ete/ttye) and also used for dialout (by tip{lC) or uucp{lC)) as /dev/cuaO when no one 
is logged in on the line. Note that the bit in the flags word in the config file (see above) must be 
zero for this line. 

WIRING 

The Systech requires the CTS modem control signal to operate. If the device does not supply 
CTS then RTS should be jumpered to CTS at the distribution panel. Also, the CD (carrier 
detect) line does not work properly. When connecting a modem, the modem's CD line should be 
wired to DSR, which the software will treat as carrier detect. 

FILES 

/dev/tty0[0-9arf) hardwired tty lines 

/dev/ttyd[0-9arf] dialin tty lines 

/dey/cu&[0-9a-^ dialout tty lines 

SEE ALSO 

tty(4), Z8(4S) 

DIAGNOSTICS 

Most of these diagnostics "should never happen" and their occurrence usually indicates problems 
elsewhere in the system. 

mt\%df%dt silo overflow. More than 512 characters have been received by the mti hardware 
without being read by the software. Extremely unlikely to occur. 

mti%d: error %x. The mti returned the indicated error code. See the mti manual. 

mti%di DMA output error. The mti encountered an error while trying to do DMA output. 

mti%d: impossible response %x. The mti returned of flags may be specified to say that a line 
is not From martyGufo Sat Feb 25 16:04:52 1984 
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NAME 

mtio - UNIX magnetic tape interface 

SYNOPSIS 

#include <^8/ioctl.h> 
#include <sy8/mtio.h> 

DESCRIPTION 

The files mtO, ..., mttS refer to the UNIX magtape drive8« which read and write magnetic tape in 
2048 byte blocks. (The 2048 is actually BLKDEVJOSIZE in <^s/param.h>.) The following 
description applies ta any of the transport/controller pairs. The files mtOf ..., mtS and mtS, ..., 
mtlJ are rewound when closed; the others are not. When a file open for writing is closed, two 
end-of-files are written. If the tape is not to be rewound it is positioned with the head between 
the two tapemark». 

The ml files discussed above are useful when it is desired to access the tape in a way compatible 
with ordinary files. When foreign tapes are to be dealt with, and especially when long records are 
to be read or written, the 'raw*^ interface is appropriate. The associated files are named rmtO, ..., 
rmitS^ but the same minor-device considerations as for the regular files still a^ply. A number <^ 
other ioctl operations are available on raw magnetic tape. The following definitions are from 
< sy s/mtio Ji > r 

/* 
* Structures and definitions for mag tape io control commands 

♦/ 

/* structure for MTIOCTOP - mag tape op command */ 
struct mtop { 



}; 



short mt_op; /* operations defined below */ 

daddr_tmt_count; /* how many of them */ 



/* operations */ 

#deflne MTWEOF /* write an end-of-file record */ 

#define MTFSF 1 /* forward space file */ 

#define MTBSF 2 /♦ backward space file */ 

#define MTFSR 3 /♦ forward space record */ 

#define MTBSR 4 /♦ backward space record */ 

#define MTREW 5 /* rewind */ 

#define MTOFFL 6 /♦ rewind and put the drive offline */ 

#define MTNOP 7 /♦ no operation, sets status only */ 

/* structure for MTIOCGET - mag tape get status command */ 

struct mtget { 

short mt_type; /* type of magtape device */ 

/* the following two registers are grossly device dependent */ 

short mt_d8reg; /♦ "drive status" register */ 

short mt_erreg; /♦ "error" register */ 

/* end device-dependent registers */ 

short mtjresid; /* residual count */ 

/* the following two are not yet implemented */ 

daddr_tmt_fileno; /* file number of current position */ 

daddr_tmt_blkno; /* block number of current position */ 

/* end not yet implemented */ 
/» 
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* Constants for mt_type byte 
*/ 


#defineMT_ISTS 


0x01 


#defineMTJSHT 


0x02 


#defineMT_ISTM 


0x03 


#defineMT_ISMT 


0x04 


#defineMTJSUT 


0x05 


#defineMT_ISCPC 


0x06 


#dcfineMTJSAR 


0x07 



/* vax: unibus ts-11 */ 

/* vax: massbus tu77, etc */ 

/* vax: unibus tm-ll */ 

/* vax: massbus tu78 */ 

/* vax: unibus gcr */ 

/* sun: Multibus tapemaster */ 

/* sun: Multibus archive */ 



j'* mag tape io control commands */ 

#define MTIOCTOP JOW(m, 1, struct mtop) 

#define MTIOCGET JOR(m, 2, struct mtget) 



/* do a mag tape op */ 
/* get tape status */ 



#ifndef KERNEL 

#defineDEFTAPE ''/dev/rmtl2'' 
#endif 

Each read or write call reads or writes the next record on the tape. In the write case the record 
has the same length as the buffer given. During a read, the record size is passed back as the 
number of bytes read, provided it is no greater than the buffer size. In raw tape I/O seeks are 
ignored. A zero byte count is returned when a tape mark is read, but another read will fetch the 
first record of the new tape file. 

PILES 

/dev/mt? 

/dev/rmt? 

/dev/rar? 

SEE ALSO 

mt(i), tar(l), ar(4S), t!n(4S) 
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NAME 

nd - network disk driver 

SYNOPSIS 

pseudo-device nd 

DESCRIPTION 

The network disk device, fdev/nd*, allows a client workstation to perform disk lO operations on a 
server system, over the network. To the client ^stem, this device looks like any normal disk 
driver: it allows read/write operations at a given block number and byte count. Note that this 
provides a network disk block access service rather than a network file access service. 

Typically the client system will have no disks at all. In this case IdevjndO contains the client's 
root file system (including /usr files), and ndl is used as a paging area. Client access to these dev- 
ices is converted to net disk protocol requests and sent to the server system over the network. 
The server receives the request, performs the actual disk ID, and sends a response back to the 
client. 

The server contains a table which lists the net address of each of his clients and the server disk 
partition which corresponds to each client unit number (ndO,l,...). This table resides in the server 
kernel in a structure owned by the nd device. The table is initialized by running the program 
fetc/nd with text file / etc/ nd. local as its input, /ete/nd then issues ioctl{2) functions to load the 
table into the kernel. 

In addition to the read/write units jdevjnd*, there are public read-only units which are named 
fdev/ndp*. The correspondence to server partitions is specified by the /etc/nd.local text file, in a 
similar manner to the private partitions. The public units can be used to provide shared access to 
binaries or libraries (/bin, /usr/bin, /usr/ucb, /usr/lib) so that each diskless client does not have 
to waste space in his private partitions for these files. This is done by providing a public file sys- 
tem at the server ( jdevjndpO ) which is mounted on '/P^^' ^^ ®^^ diskless client. The clients 
then use symbolic links to read the public files: /bin -> /pub/bin, /usr/ucb -> /pub/usr/ucb. 
One requirement in this case is that the server (who has read/write access to this file system) 
should not perform write activity with any public filesystem. This is because each client is locally 
cacheing blocks. 

One last type of unit is provided for use by the server. These are called local units and are 
named /dev/ndl*. The Sun physical disk sector label only provides a limited number of parti- 
tions per physical disk (eight). Since this number b small and these partitions have somewhat 
fixed meanings, the nd driver itself has a eubpartitioning capability built-in. This allows the large 
server physical disk partition (e.g. /dev/xyOg ) to be broken up into any number of diskless client 
partitions. Of course on the client side these would be referenced as /dev/ndO,!,... ; but the 
server needs to reference these client partitions from time to time, to do mkf8{S) and f8ck(S) for 
example. The /dev/ndl" entries allow the server 'local' access to his subpartitions without causing 
any net activity. The actual local unit number to client unit number correspondence is again 
recorded in the /etc/nd.local text file. 

The nd device driver is the same on both the client and server sides. There are no user level 
processes associated with either side, thus the latency and transfer rates are close to maximal. 

The minor device and ioctl encoding used is given in file <sun/ndio.h>. The low six bits of the 
minor number are the unit number. The 0x40 bit indicates a public unit; the 0x80 bit indicates a 
local unit. 

INITIALIZATION 

No special initialization is required on the client side; he finds the server by broadcasting the ini- 
tial request. Upon getting a response, he locks onto that server address. 

At the server, the nd{Sc) command initializes the network disk service by issuing ioctl's to the 
kernel. 
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ERRORS 

Generally physical disk lO errors detected at the server are returned to the client for action. If 
the server is down or unaccessable, the client will see the console message file server not respond- 
ing: still trying. The client continues (forever) making his request until he gets positive ack- 
nowledgement from the server. This means the server can crash or power down and come back 
up without any special action required of the user at the client machine. It also means the pro- 
cess performing the 10 to nd will block, insensitive to signals, since the process is sleeping inside 
the kernel at PRIBIO, 

PROTOCOL AND DRIVER INTERNALS 

The protocol packet is defined in <sunfndio.k> and also included below: 

/• 

* *nd* protocol packet format. 

•/ 

struct 



ndpack 

struct 

u_char 

u_char 

char 

char 

long 

long 

long 

long 

long 

long 



( 

ip npjpi 

np.op; 

np^min; 

npjerrori 

npjveri 

npjiSfU 

npjblknoi 

npjbcount) 

npjresldf 

npjcaddr; 

npjceount} 



/* 
/* 
/• 
/* 
/* 
/* 
/• 
/• 
/* 
/• 
/* 
/• 



Ip header, proto IPPROTO_ND */ 
operation code, see below */ 
minor device */ 
b_error */ 
version number */ 
sequence number */ 
b_blkno, disic block number */ 
bjbeount, byte count */ 
bjresid, raidual byte count */ 
current byte offset of this packet */ 
current byte count of thb packet */ 
data follows */ 



/* np op operation codes. */ 
#define NDOPREAD 
#deflne NDOPWRITE 
#deflne NDOPERROR 
#deflne NDOPCODE 
#deflne NDOPWAIT 
#deflne NDOPDONE 

/* misc protocol defines. */ 
#define NDMAXDATA 
#define NDMAXIO 



1 /♦ read */ 

2 /♦ write */ 

3 /* error */ 
7 /* op code mask */ 

010 /* waiting for DONE or next request */ 

020 /* operation done */ 



1024 /* max data per packet */ 
OS* 1024 /* max npjbcount */ 



IP datagrams were chosen instead of UDP datagrams because only the IP header is checksummed, 
not the entire packet as in UDP. Also the kernel level interface to the IP layer is simpler. The 
min, blkno, and beount fields are copied directly from the client's strategy request. The sequence 
number field seq is incremented on each new client request and is matched with incoming server 
responses. The server essentially echos the request header in his responses, altering certain fields. 
The caddr and eeount fields show the current byte address and count of the data in this packet, or 
the data expected to be sent by the other side. 

The protocol is very simple and driven entirely from the client side. As soon as the client ndstrar 
tegy routine is called, the request is sent to the server; this allows disk sorting to occur at the 
server as soon as possible. Transactions which send data (client writes on the client side, client 
reads on the server side) can only send a set number of packets of NDMAXDATA bytes each, 
before waiting for an acknowledgement. The defaults are currently set at 6 packets of IK bytes 
each; the NDIOCETHER ioctl allows setting this value on the server side. This allows the 
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normal 4K byte case to occur with just one 'transaction'. The NDOPWAIT bit is set in the op 
field by the sender to indicate he will send no more until acknowledged (or requested) by the 
other side. The NDOPDONE bit is set by the server side to indicate the request operation has 
completed; for both the read and write cases this means the requested disk 10 has actually 
occured. 

Requests received by the server are entered on an active list which is timed out and discarded if 
not completed within NDXTIMER seconds. Requests received by the server allocate a bcount size 
bufTer to minimize buffer copying. Contiguous DMA disk 10 thus occurs in the same size chunks 
it would if requested from a local physical disk. 

BOOTSTRAP 

The Sun workstation has PROM code to perform a net boot using thb driver. Usually, the boot 
files are obtained from public device (/dev/ndpO) on the server with which the client is 
registered; this allows multiple servers to exist on the same net (even running different releases of 
kernel and boot software). If the station you are booting is not registered on any of the servers, 
you will have to specify the hex Internet host number of the server in the boot command string 
(e.g.): 'bec(0,5,0)vmunix'. 

This booting performs exactly the same steps involved in a real disk boot which are: 

1) user types 'b' to PROM monitor. 

2) PROM loads blocks 1 thru 15 of /dev/ndpO (bootpr). 

3) bootnd loads '/boot'. 

4) /boot loads '/vmunix'. 

SEE ALSO 

ioctl(2), nd(8C) 

BUGS 

The operations described in dkio{4) are not supported. 

The local host's disk buffer cache is not used by network disk access. This means that if either a 
local host or a remote host is writing, the changes will be visible at random based on the cache hit 
frequency on the local host. If both the local and remote hosts are writing to the same filesystem, 
one machine's changes can be randomly lost, based again on cache hit and deferred write timings. 

If an R/0 remote file system is mounted R/W by mistake, it is impossible to umount it. 
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NAME 

null - data sink 

SYNOPSIS 

None; included with standard system. 

l>ESCRIPTION 

Data written on a null special file is dbcarded. 

Reads from a null special file always return an end-of-file indication. 

FILES 

/dev/null 



Sun Releas|(t 1.1 Last change: 17 August 1983 39 



0CT(4S) SPECIAL FILES OCT(4S) 



NAME 

oct - Central Data octal serial card 

SYNOPSIS 

devlee octO at mbO car Qx520 fiaga Oxff priority 4 

DESCRIPTION 

The Central Data card provides 8 serial commuDieation lines with modem control. Each tine 
behaves as described in tfif(4). Input and output for each line may independently^ be set to run at 
any of 16 speeds; see ttjf^i) for the encoding. 

Bit i of flags may be specified to say that a line ts not properly connected, and that the line » 
should be treated as hard-wired with carrier always present. Thus specifying '^flags OxOOOi" in 
the specification of oetO would cause line ttym2 to be treated in this way. 

FILES 

/dev/t^|mno}f0-9arfj 
/dev/t^4[(^9a^ft 

SEE ALSO 

tty(4j, zs(4S} 

Hardware Reference Kfenual; Octal Serial Interface; Central Data Corporatfon (Sun 800-0418) 

DIAGNOSTICS 

None. 

BUGS 

Input data overruns are silently ignored. 

This interrupt-per-character, non-buffered device is expensive in terms of system overhead. 
This driver is not supported. 



40 Last change: 11 August 1983 Sun Release 1.1 



PTY(4) SPECIAL FILES PTY(4) 



NAME 

pty - pseudo terminal driver 

SYNOPSIS 

pseudo-device pty 

DESCRIPTION 

The pty driver provides support for a pair of devices collectively known as a pseudo-terminal. 
The two devices comprising a pseudo- terminal are known as a master and a stave. The slave dev- 
ice provides an interface identical to that described in tty{4), but instead of having a hardware 
interface such as the Zilog chip and associated hardware used by zs{4S) supporting the terminal 
functions, the functions of the terminal are implemented by another process manipulating the 
master side of the pseudo-terminal. 

The master and the slave sides of the pseudo-terminal are tightly connected. Any data written on 
the master device is given to the slave device as input, as though it had been received from a 
hardware interface. Any data written on the slave terminal can be read from the master device 
(rather than being transmitted from a UART). 

In configuring, if no optional "count" is given in the specification, 16 pseudo terminal pairs are 
config;ured. 

A few special ioctl's t^re provided on the control-side devices of pseudo-terminals to provide the 
functionality needed by applications programs to emulate real hardware interfaces: 

TIOCSTOP 

Stops output to a terminal (that is, like typing 'S). Takes no parameter. 

TIOCSTART 

Restarts output (stopped by TIOCSTOP or by typing *Q). Takes no parameter. 

There a^e also two independent modes which can be used by applications programs: 

TIOCPKT 

Enable/disable packet mode. Packet mode is enabled by specifying (by reference) a 
nonzero parameter and disabled by specifying (by reference) a zero parameter. When 
applied to the master side of a pseudo terminal, each subsequent read from the terminal 
will return data written on the slave part of the pseudo terminal preceded by a zero byte 
(^mbolically defined as TIOCPKTJDATA), or a single byte reflecting control status 
information. In the latter cas6, the byte is an inclusive-or of zero or more of the bits: 

TIOCPKT.FLUSHREAD 

whenever the read queue for the terminal is flushed. 

TIOCPKT.FLUSHWRITE 

whenever the write queue for the terminal is flushed. 

TIOCPKT_STOP' 

whenever iJutput to the terminal is stopped a la 'S. 

TIOCPKT^START 

whenever output to the terminal is restarted. 

TIOCPKT.DGSTOP 

whenever tjstopc is *S and t_startc is "Q. 

TIOCPKT_NOSTOP 

whenever the start and stop characters are not 'S/'Q. 

This mode is used by rlogin{lC) and rlogind{SC) to implement a remote-echoed, locally 
*S/*Q flow-controlled remote login with proper back-flushing of output when interrupts 
occur; it can be used by other similar programs. 

TIOCREMOTE 
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A mode for the master half of a pseudo terminal, independent of TIOCPKT. This mode 
causes input to the pseudo terminal to be flow controlled and not input edited (regardless 
of the terminal mode). Each write to the control terminal produces a record boundary for 
the process reading the terminal. In normal usage, a write of data is like the data typed 
as a line on the terminal; a write of bytes is like typing an end-of-fiie character. 
TIOCR EMOTE can be used when doing remote line editing in a window manager, or 
whenever flow controlled input is required. 



FILES 



/dev/pty[p-r)[0-9ar^ master pseudo terminals 
/dev/tty(p-r]|0-9a-f| slave pseudo terminals 

BUGS 

It is apparently not possible to send an EOT by writing zero bytes in TIOCREMOTE mode. 
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NAME 

routing - system supporting for local network packet routing 

DESCRIPTION 

The network facilities provided general packet routing, leaving routing table maintenance to 
applications processes. 

A simple set of data structures comprise a "routing table" used in selecting the appropriate net- 
work interface when transmitting packets. This table contains a single entry for each route to a 
specific network or host. A user process, the routing daemon, maintains this data base with the 
aid of two socket specific ioctl{2) commands, SIOGADDRT and SIOCDELRT. The commands 
allow the addition and deletion of a single routing table entry, respectively. Routing table mani- 
pulations may only be carried out by super-user. 

A routing table entry has the following form, as defined in <netl route. h>; 



struct rtentry { 




ujong 


rt_ha8h; 


struct 


sockaddr rt_dst; 


struct 


sockaddr rt_gateway; 


short 


rt^flags; 


short 


rtjrefcnt; 


u Jong 


rt_use; 


struct 


ifnct *rt_ifp; 



}; 

with rtjiaga defined from, 

#defineRTFJJP 0x1 /* route usable */ 

#defineRTF_GATEWAY 0x2 /* destination is a gateway */ 

#defineRTF_HOST 0x4 /* host entry (net otherwise) */ 

Routing table entries come in three flavors: for a specific host, for all hosts on a specific network, 
for any destination not matched by entries of the first two types (a wildcard route). When the 
system is booted, each network interface autoconfigured installs a routing table entry when it 
wishes to have packets sent through it. Normally the interface specifies the route through it is a 
"direct" connection to the destination host or network. If the route is direct, the transport layer 
of a protocol family usually requests the packet be sent to the same host specified in the packet. 
Otherwise, the interface may be requested to address the packet to an entity different from the 
eventual recipient (i.e. the packet is forwarded). 

Routing table entries installed by a user pi'ocess may not specify the hash, reference count, use, or 
interface fields; these are filled in by the routing routines. If a route is in use when it is deleted 
[rtjrefcnt b non-zero), the resources associated with it will not be reclaimed until further refer- 
ences to it are released. 

The routing code returns EEXIST if requested to duplicate an existing entry, ESRCH if requested 
to delete a non-existant entry, or ENOBUFS if insufficient resources were available to install a 
new route. 

User processes r^ad the routing tables through the /dev/kmem device. 

The rt^use field contains the number of packets sent along the route. This value is used to select 
among multiple routes to the same destination. When multiple routes to the same destination 
exist, the least used route is selected. 

A wildcard routing entry is specified with a zero destination address value. Wildcard routes are 
used only when the system faik to find a route to the destination host and network. The combi- 
nation of wildcard routes and routing redirects can provide an economical mechanism for routing 



Sun Release 1.1 Last change: 15 August 1983 43 



ROUTING (4N) SPECIAL FILES R OUTING (4N) 



traffic. 
SEE ALSO 



rbute(8C), routed(8C) 
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sd - Disk driver for Adaptec ST-506 Disk Controllers 

SYNOPSIS 

controller scO at mbO ear 0x80000 priority 2 
disk sdO at scO drive flags 
disk sdl at 6c0 drive 1 flags 

DESCRIPTION 

Files with minor device numbers through 7 refer to various portions of drive 0. The standard 
device names begin with "sd" followed by the drive number and then a letter a-h for partitions 
0-7 respectively. The character ? stands here for a drive number in the range 0-7. 

The block file's access the disk via the system's normal buffering mechanism and may be read and 
written without regard to physical disk records. There is also a 'raw' interface which provides for 
direct transmission between the disk and the user's read or write buffer. A single read or write 
call results in exactly one I/O operation and therefore raw I/O is considerably more effficient 
when many words are transmitted. The names of the raw files conventionally begin with an extra 
•r.' 

Is raw I/O counts should be a multiple of 512 bytes (a disk sector). Likewise seek calls should 
specify a multiple of 512 bytes. 

DISK SUPPORT 

This driver handles all ST-506 drives, by reading a label from sector of the drive which 
describes the disk geometry and partitioning. 

The sd?a partition is normally used for the root file system on a disk, the sd?b partition as a pag- 
ing area, and the 8d?c partition for pack-pack copying (it normally maps the entire disk). The 
^ rest of the disk is normally the 8d?h partition. 



FILES 



/dev/sd[0-7]|arh] block files 

/dev/rsd [0-71 [a-h] raw files 



SEE ALSO 

dkio(4S) 

Adaptec ACB 4000 and 5000 Series Disk Controllers OEM Manual 

DIAGNOSTICS 

Bd%d%zx emd how (meg) blk %d. A command such as read or write encountered a error condi- 
tion (how): either it failed, the unit was restored, or an operation was retrj/ed. The msg is 
derived from the error number given by the controller, indicating a condition such as "drive not 
ready" or "sector not found". 



BUGS 



In raw I/O read and write{2) truncate file offsets to 512-byte block boundaries, and write scribbles 
on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, read, 
write and l8eek{2) should always deal in 512-byte multiples. 
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NAME 

st - Driver for Sysgen SC 4000 (Archive) Tape Controller 

SYNOPSIS 

controller scO at mbO car 0x80000 priority 2 
tape stO at scO drive 32 flags 1 

DESCRIPTION 

The Sysgen tape controller is a SCSI bus interface to an Archive streaming tape drive. It pro- 
vides a standard tape interface to the device, see tntio{i), with some deficiencies listed under 
BUGS below. 



FILES 



/dev/rstO 

/dev/nrstO non-rewinding 



SEE ALSO 

mtio(4), tm(4S) 

Sysgen SC4000 Intelligent Tape Controller Product Specification 

Archive Intelligent Tape Drive Theory of Operation, Archive Corporation (Sun 8000-1058-01) 

Archive Product Manual (Sidewinder 1/4" Streaming Cartridge Tape Drive) (Sun 800-0628-01) 

DIAGNOSTICS 

8t%dt tape not online. 

Bt%di no cartridge In drive. 

0t%di cartridge is write protected. 



BUGS 



The tape cannot reverse direction so BSF and BSR are not available. 

Disk I/O over the SCSI bus will be mostly blocked out when the tape is in use. This is because 
the controller does not free the bus while the tape b in motion (even during rewind). 

When using the raw device, the number of bytes in any given transfer must be a multiple of 512 
bytes. If it is not, the device driver returns an error. 
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NAME 

tcp - Interact Transmission Control Protocol 

SYNOPSIS 

None; comes automatically with inet(AF). 

DESCRIPTION 

TCP is a connection-oriented, end-to-end reliable protocol designed to fit into a layered hierarch 
of protocob which support multi-network applications. TCP provides for reliable inter-process 
communication between pairs of processes in host computers attached to distinct but intercon- 
nected computer communication networks. Very few assumptions are made as to the reliability 
of the communication protocols below TCP layer. TCP assumes it can obtain a simple, poten- 
tially unreliable datagram service from the lower level protocols. In principle, TCP should be 
able to operate above a wide spectrum of communication systems ranging from hard-wired con- 
nections to packet-switched or circuit switched networks. 

TCP fits into a layered protocol architecture just above the basic Internet Protocol (IP) described 
in tp(4P) which provides a way for TCP to send and receive variable-length segments of informa- 
tion enclosed in Internet datagram "envelopes." The Internet datagram provides a means for 
addressing source and destination TCPs in different networks, deals with any fragmentation or 
reassembly of the TCP segments required to achieve transport and delivery through multiple 
netwokrs and interconnecting gateways, and has the ability to carry information on the pre- 
cedence, security classification and compartmentalization of the TCP segments (although this is 
not currently implemented under UNIX.) 

An application process interfaces to TCP through the 8ocket{2) abstraction and the related calles 
bind{2), H8ten{2), accept{2), connect{2), 8end{2) and recv(2). The primary purpose of TCP is to 
provide a reliable bidirectional virtual circuit service between pairs of processes. In general, the 
TCP's decide when to block and forward data at their own convenience. In the UNIX implemen- 
tation, it is assumed that any buffering of data is done at the user level, %nd the TCP's transmit 
available data as soon as possible to their remote peer. They do this and always set the PUSH bit 
indicating that the transferred data should be made available to the user process at the remote 
end as soon as practicable. 

To provide reliable data TCP must recover from data that is damaged, lost, duplicated, or 
delivered out of order by the underlying internet communications system. This is achieved by 
assigning a sequence number to each byte of data transmitted and requiring a positive ack- 
nowledgement from the receiving TCP. If the ACK is not received within an (adaptively deter- 
mined) timeout interval the data is retransmitted. At the receiver, the sequence numbers are 
used to correctly order segments that may be received out of order and to eliminate duplicates. 
Damage is handled by adding a checksum to each segment transmitted, checking it at the 
receiver, and discarding damaged segments. As long as the TCP's continue to function properly 
and the internet system does nbt, become completely partitioned, no tranmission errors will affect 
the correct delivery of data, as TbP recovers from communications errors. 

TCP provides flow control over the transmitted data. The receiving TCP is allowed to specify 
the amount of data which may be sent by the sender, by returning a window with every ack- 
nowledgement indicating a range of acceptable sequence numbers beyond the last segment suc- 
cessfully received. The window indicates an allowed number of bytes that the sender may 
transmit before receiving further permission. 

TCP extends the standard 32-bit Internet host addresses with a 16-bit port number space; the 
combined addresses are available at the UNIX process level in the standard 8ockaddr_in format 
described in inet{4F). 

Sockets utilizing the tcp protocol are either "active" or "passive". Active sockets initiate connec- 
tions to passive sockets. By default TCP sockets are created active; to create a passive socket the 
li8ten{2) system call must be used after binding the socket to an address with the bind{2) system 
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call. Only passive sockets may use the accept{2) call to accept incoming connections. Only 
active sockets may use the connect{2) call to initiate connections. 

Passive sockets may "underspecify" their location to match incoming connection requests from 
multiple networks. This technique, termed "wildcard addressing", allows a single server to pro- 
vide service to clients on multiple networks. To create a socket which listens on all networks, the 
Internet address INADDR_ANY must be bound. The TCP port may still be specified at this 
time; if the port is not specified the system will assign one. Once a connection has been estar 
blished the socket's address is fixed by the peer entity's location. The address assigned the 
socket is the address associated with the network interface through which packets are being 
transmitted and received. Normally this address corresponds to the peer entity's network. See 
inet{4F) for a complete description of addressing in the Internet family. 

A TCP connection is created at the server end by doing a 80cket{2), a bmd{2) to establbh the 
address of the socket, a li9ten{2) to cause connection queueing, and then an accept{2) which 
returns the descriptor for the socket. A client connects to the server by doing a socket{2) and 
then a connect{2). Data may then be sent from server to client and back using read{2) and 
write{2). 

TCP implements a very weak out-of-band mechanism, which may be invoked using the out-of- 
band provisions of 8end{2). This mechanism allows setting an urgent pointer in the data stream; 
it is reflected to the TCP user by making the byte after the urgent pointer available as out-of- 
band data and providing a SIOCATNfARK ioctl which returns an integer indicating whether the 
stream is at the urgent mark. The ^stem never returns data across the urgent mark in a single 
read. Thus when a SIGURG signal is received indicating the presence of out-of-band data and 
the out-of-band data indicates that the data to the mark should be flushed (as in remote terminal 
processing) it suffices to loop checking whether you are at the out-of-band mark, and reading data 
while you are not at the mark. 

SEE ALSO 

inet(4F), ip(4P) 

BUGS 

It should be possible to send and receive TCP options. 

The system always tries to negotiates the maximum TCP segment size to be 1024 bytes. This 
can result in poor performance if an intervening network performs excessive fragmentation. 

SIOCSHIWAT and SIOCGHIWAT ioctl's to set and get the high water mark for the socket 
queue, and so that it can be changed from 2048 bytes to be larger or smaller, have been defined 
(in <sys/ioctl.h>) but not implemented. 
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NAME 

tm - tapemaster 1/2 inch tape drive 

SYNOPSIS 

controller tmO at mbO car OxaO priority 3 
tape mtO at tmO drive flags 1 

DESCRIPTION 

The Tapemaster tape controller controls Pertec-interface 1/2" tape drives such as the CDC Key- 
stone, providing a standard tape interface to the device, see mtio{4). 

SEE ALSO 

mt(l), tar(l), ar(4S) 

CPC Tapemaster Product Specification (Sun 800-0620-01) 

CPC Tapemaster Application Note (Sun 800-0622-01) 

CDC Streaming Tape Unit 9218X Reference Manual (Sun 800-0623-01) 

DIAGNOSTICS 

tm%d: no response from ctlr. 

tm%di error %d during config. 

mt%ds not online. 

mt^dt no write ring. 

tmgos gate wasn't open. Controller lost synch. 

tmintrs can't clear interrupts. 

tm%ds stray interrupts. 

tat%dt hard error bns=%d eTsss%x. 

mt^di lost interrupt. 



BUGS 



The Tapemaster controller does not provide for byte-swapping and the resultant system overhead 
prevents streaming transports from streaming. 

If a non-data error is encountered on non-raw tape, it refuses to do anything more until closed. 

The ^stem should remember which controlling terminal has the tape drive open and write error 
messages to that terminal rather than on the console. 
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NAME 

tty - general terminal interface 

SYNOPSIS 

None; included by default. 

DESCRIPTION 

This section describes both a particular special file /dev/tty and the terminal drivers used for 
conversational computing by serial interfaces such as 0c{(4S), Z8{4S), as well as con«(4S) and 

pty{i). 

Line disciplines. 

The system provides di£ferent line dieciplinea for controlling communications lines. In this version 
of the system there are three disciplines available: 

old The old (standard) terminal driver. This is used when using the standard shell 8h{l) and 

for compatibility with version 7 UNDC systems. 

new A newer terminal driver, with features for job control; this must be used when using 

C8h{l). 

net A line discipline used for networking and loading data into the system over communicar 

tions lines. It allows high speed input at very low overhead, and b described in hk{A). 

Line discipline switching is accomplished with the TIOCSETD iocti: 

int Idise » LDISCi ioetl(f, TIOCSETD, ^Idise); 

where LDISC is OTTYDISC for the standard tty driver, NTTYDISC for the new driver and 
NETLDISC for the networking discipline. The standard (currently old) tty driver is discipline 
by convention. The current line dbcipline can be obtained with the TIOCGETD ioctl. Pending 
input is discarded when the line discipline is changed. 

All of the low-speed asynchronous communications ports can use any of the available line discip- 
lines, no matter what hardware is involved. The remainder of this section discusses the "old" and 
"new" disciplines'^ 

The control terminal. 

When a terminal file is opened, it causes the process to wait until a connection is established. In 
practice, user programs seldom open these files; they are opened by init{8) and become a user's 
standard input and output file. 

If a process which has no control terminal opens a terminal file, then that terminal file becomes 
the control terminal for that process. The control terminal is thereafter inherited by a child pro- 
cess, during a fork(2), even if the control terminal is closed. 

The file /dev/tty is, in each process, a synonym for a control terminal associated with that pro- 
cess. It is useful for programs that wish to be sure of writing messages on the terminal no matter 
how output has been redirected. It can also be used for programs that demand a file name for 
output, when typed output is desired and it is tiresome to find out which terminal is currently in 
use. 

A process can remove the association it has with its controlling terminal by opening the file 
/dev/tty and issuing a 

ioctl(f, TIOCNOTTY, 0); 

This is often desirable in server processes. 
Process groups. 

Command processors such as C8h{l) can arbitrate the terminal between different job8 by placing 
related jobs in a single process group and associating this process group with the terminal. A 
terminal's associated process group may be set using the TIOCSPGRP ioctl{2): 
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ioctl(fllde8, TIOCSPGRP, &pgrp) 

or examined using TIOCGPGRP, returning the current process group in pgrp. The new terminal 
driver aids in this arbitration by restricting access to the terminal by processes which are not in 
the current process group; see Job access control below. 

Modes. 

The terminal drivers have three major modes, characterized by the amount of processing on the 
input and output characters: 

cooked The normal mode. In this mode lines of input are collected and input editing is done. 
The edited line is made available when it is completed by a newline or when the 
t_^brkc character, normally an EOT (control-D, hereafter "D), is entered. A carriage 
return is usually made synonymous with newline in this mode, and replaced with a 
newline whenever it is typed. All driver functions (input editing, interrupt generation, 
output processing such as delay generation and tab expansion, etc.) are available in 
this mode. 

CBEEAK This mode eliminates the character, word, and line editing input facilities, making the 
input character available to the user program as it is typed. Flow control, literal-next 
and interrupt processing are still done in this mode. Output processing is done. 

RAW This mode eliminates all input processing and makes all input characters available as 

they are typed; no output processing is done either. 

The style of input processing can also be very different when the terminal is put in non-blocking 
l/o mode; see the FNDELAY flag as described in fcntl{2). In this case a r€ad(2) from the control 
terminal will never block, but rather return an error indication (EWOULDBLOCK) if there is no 
input available. 

A process may also request a SIGIO signal be sent it whenever input is present. To enable this 
mode the FASYNC flag should be set using fcnU{2). 

Input editing. 

A UNIX terminal ordinarily operates in full-duplex mode. Characters may be typed at any time, 
even while output is occurring, and are only lost when the system's character input buffers 
become completely choked, which is rare, or when the user has accumulated the maximum 
allowed number of input characters that have not yet been read by some program. Currently this 
limit is 256 characters. In the old terminal driver all the saved characters are thrown away when 
the limit b reached, without notice; the new driver simply refuses to accept any further input, 
and rings the terminal bell. 

Input characters are normally accepted in either even or odd parity with the parity bit being 
stripped off before the character is given to the program. By clearing either the EVEN or ODD 
bit in the flags word it is possible to have input characters with that parity discarded (see the 
Summary below.) 

In all of the line disciplines, it is possible to simulate terminal input using the TIOCSTI ioctl, 
which takes, as its third argument, the address of a character. The system pretends that this 
character was typed on the argument terminal, which must be the control terminal except for the 
super-user (this call b not in standard version 7 UNIX). 

Input characters are normally echoed by putting them in an output queue as they arrive. This 
may be disabled by clearing the ECHO bit in the flags word using the 8tty(3C) call or the 
TIOCSETN or TIOCSETP ioctls (see the Summary below). 

In cooked mode, terminal input is processed in units of lines. A program attempting to read will 
normally be suspended until an entire line has been received (but see the description of SIGTTIN 
in Modes above and FIONREAD in Summary below.) No matter how many characters are 
requested in the read call, at most one line will be returned. It is not, however, necessary to read 
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a whole line at once; any number of characters may be requested in a read, even one, without los- 
ing information. 

During input, line editing ia normally done, with the DELETE character logically erasing the last 
character typed and a *U (control-U) logically erasing the entire current input line. These charac- 
ters never erase beyond the beginning of the current input line or an "D. These characters may 
be entered literally by preceding them with '\ '; in the old teletype driver both the '\ ' and the 
character entered literally will appear on the screen; in the new driver the '\ ' will normally disap- 
pear. 

The drivers normally treat either a carriage return or a newline character as terminating ao input 
line, replacing the return with a newline and echoing a return and a line feed. If the CRMOD bit 
is cleared in the local mode word then the processing for carriage return is disabled, and it is sim- 
ply echoed as a return, and does not terminate cooked mode input. 

In the new driver there is a literal-next character 'V which can be typed in both cooked and 
CBREAK mode preceding any character to prevent its special meaning. This is to be preferred 
to the use of '\ ' escaping erase and kill characters, but '\ ' is (at least temporarily) retained with 
its old function in the new driver for historical reasons. 

The new terminal driver also provides two other editing characters in normal mode. The word- 
erase character, normally 'W, erases the preceding word, but not any spaces before it. For the 
purposes of 'W, a word is deflned as a sequence of non-blank characters, with tabs counted as 
blanks. Finally, the reprint character, normally 'R, retypes the pending input beginning on a 
new line. Retyping occurs automatically in cooked mode if characters which would normally be 
erased from the screen are fouled by program output. 

Input echoing and redisplay 

In the old terminal driver, nothing special occurs when an erase character is typed; the erase char- 
acter is simply echoed. When a kill character is typed it is echoed followed by a new-line (even if 
the character is not killing the line, because it was preceded by a '\'!,) 

The new terminal driver has several modes for handling the echoing of terminal input, controlled 
by bits in a local mode word. 

Hardcopy terminals. When a hardcopy terminal is in use, the LPRTERA bit is normally set in the 
local mode word. Characters which are logically erased are then printed out backwards preceded 
by '\ ' and followed by '/' ^^ ^^^ mode. 

Crt terminals. When a crt terminal is in use, the LCRTBS bit is normally set in the local mode 
word. The terminal driver then echoes the proper number of backspace characters when input is 
erased to reposition the cursor. If the inpiit has become fouled due to interspersed asynchronous 
output, the input is atitomatically retyped. 

Erasing characters from a crt. When a crt terminal is in use, the LCRTERA bit may be set to 
cause input to be erased from the screen with a "backspace-space-backspace" sequence when 
character or word deleting sequences are used. A LCRTKIL bit may be set as well, causing the 
input to be erased in this manner on line kill sequences as well. 

Echoing of control characters. If the LCTLECH bit is set in the local state word, then non- 
printing (control) characters are normally echoed as 'X (for some X) rather than being echoed 
unmodified; delete is echoed as '?. 

The normal modes for using the new terminal driver on crt terminals are speed dependent. At 
speeds less than 1200 baud, the LCRTERA and LCRTKILL processing is painfully slow, so 
stty[l) normally just sets LCRTBS and LCTLECH; at speeds of 1200 baud or greater all of these 
bits are normally set. The stty[\) command summarizes these option settings and the use of the 
new terminal driver as "newcrt." 
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Output processing. 

When one or more characters are written, they are actually transmitted to the terminal as soon as 
previously-written characters have finished typing. (As noted above, input characters are nor- 
mally echoed by putting them in the output queue as they arrive.) When a process produces char- 
acters more rapidly than they can be typed, it will be suspended when its output queue exceeds 
some limit. When the queue has drained down to some threshold the program is resumed. Even 
parity is normally generated on output. The EOT character is not transmitted in cooked mode to 
prevent terminals that respond to it from hanging up; programs using raw or cbreak mode should 
be careful. 

The terminal drivers provide necessary processing for cooked and CBREAK mode output includ- 
ing delay generation for certain special characters and parity generation. Delays are available 
after backspaces 'H, form feeds 'L, carriage returns 'M, tabs 'I and newlines 'J. The driver will 
also optionally expand tabs into spaces, where the tab stops are assumed to be set every eight 
columns. These functions are controlled by bits in the tty flags word; see Summary below. 

The terminal drivers provide for mapping between upper and lower case on terminals lacking 
lower case, and for other special processing on deficient terminals. 

Finally, in the new terminal driver, there is an output flush character, normally 'O, which sets 
the LFLUSHO bit in the local mode word, causing subsequent output to be flushed until it is 
cleared by a program or more input is typed. This character has effect in both cooked and 
CBREAK modes and causes pending input to be retyped if there is any pending input. An ioctl 
to flush the characters in the input and output queues, TIOCFLUSH, is also available. 

Upper case terminals and Haseltines 

If the LCASE bit is set in the tty flags, then aH upper-case letters are mapped into the 
corresponding lower-case letter. The upper-case letter may be generated by preceding it by '\'. If 
the new terminal driver is being used, then upper case letters are preceded by a '\ ' when output. 
In addition, the following escape sequences can be generated on output and accepted on input: 

for ^ I ~ { } 

use \' V V \( \) 

To deal with Hazeltine terminals, which do not understand that ~ has been made into an ASCII 

character, the LTILDE bit may be set in the local mode word when using the new terminal 

driver; in this case the character ~ will be replaced with the character ^ on output. 

Flow control. 

There are two characters (the stop character, normally 'S, and the start character, normally *Q) 
which cause output to be suspended and resumed respectively. Extra stop characters typed when 
output is already stopped have no effect, unless the start and stop characters are m^de the same, 
in which case output resumes. 

A bit in the flags word may be set to put the terminal into TANDEM mode. In this mode the 
system produces a stop character (default ''S) when the input queue is in danger of overflowing, 
and a start character (default 'Q) when the input has drained sufficiently. This mode is useful 
when the terminal is actually another machine that obeys the conventions. 

Line control and breaks. 

There are several ioetl calls available to control the state of the terminal line. The TIOCSBRK 
ioctl will set the break bit in the hardware interface causing a break condition to exist; this can 
be cleared (usually after a delay with 8leep{3)) by TIOCCBRK. Break conditions in the input are 
reflected as a null character in RAW mode or as the interrupt character in cooked or CBREAK 
mode. The TIOCCDTR ioctl will clear the data terminal ready condition; it can be set again by 
TIOCSDTR. 
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When the carrier signal from the dataset drops (usually because the user has hung up his termi- 
nal) a SIGHUP hangup signal is sent to the processes in the distinguished process group of the ter- 
minal; this usually causes them to terminate (the SIGHUP can be suppressed by setting the 
LNOHANG bit in the local state word of the driver.) Access to the terminal by other processes is 
then normally revoked, so any further reads will fail, and programs that read a terminal and test 
for end-of-file on their input will terminate appropriately. 

When using an ACU it is possible to ask that the phone line be hung up on the last close with the 
TIOCHPCL ioctl; this is normally done on the outgoing line. 

Interrupt characters. 

There are several characters that generate interrupts in cooked and CBREAK mode; all are sent 
to the processes in the control group of the terminal, as if a TIOCGPGRP ioctl were done to get 
the process group and then a kiUpg{2) system call were done, except that these characters also 
flush pending input and output when typed at a terminal {&" 'la TIOCFLUSH). The characters 
shown here are the defaults; the field names in the structures (given below) are also shown. The 
characters may be changed. 

*C tjntrc (ETX) generates a SIGINT signal. This is the normal way to stop a process 
which is no longer interesting, or to regain control in an interactive program. 

'\ t_qultc (FS) generates a SIGQUIT signal. This is used to cause a program to terminate 

and produce a core image, if possible, in the file core in the current directory. 

'Z tjiuspe (EM) generates a SIGTSTP signal, which is used to suspend the current process 

group. 

"Y t_dBUspe (SUB) generates a SIGTSTP signal as ''Z does, but the signal is sent when a 
program attempts to read the 'Y, rather than when it is typed. 

Job access control. 

When using the new terminal driver, if a process which is not in the distinguished process group 
of its control terminal attempts to read from that terminal its process group is sent a SIGTTIN 
signal. This signal normally causes the members of that process group to stop. If, however, the 
process is ignoring SIGTTIN, has SIGTTIN blocked, is an orphan process, or b in the middle of 
process creation using vfork{2)), it is instead returned an end-of-file. (An orphan process is a pro- 
cess whose parent has exited and has been inherited by the init{S) process.) Under older UNIX 
systems these processes would typically have had their input files reset to /dev/null, so this is a 
compatible change. 

When using the new terminal driver with the LTOSTOP bit set in the local modes, a process is 
prohibited from writing on its control terminal if it is not in the distinguished process group for 
that terminal. Processes which are holding or ignoring SIGTTOU signals, which are orphans, or 
which are in the middle of a vfork(2) are excepted and allowed to produce output. 

Summary of modes. 

Unfortunately, due to the evolution of the terminal driver, there are 4 different structures which 
contain various portions of the driver data. The first of these (sgttyb) contains that part of the 
information largely common between version 6 and version 7 UNIX ^stems. The second contains 
additional control characters added in version 7. The third is a word of local state peculiar to the 
new terminal driver, and the fourth is another structure of special characters added for the new 
driver. In the future a single structure may be made available to programs which need to access 
all this information; most programs need not concern themselves with all this state. 

Basic modes: sgttv. 

The basic ioctls use the structure defined in <8gtty.h>: 
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struct sgttyb { 

char ■g.lspeed; 

char sg^ospeed) 

char Bg^erase; 

char Bg_kUl; 

short sg_fiag8| 
}l 

The egjispeed and «^_oapee(f fields describe the input and output speeds of the device according to 
the following table, which corresponds to the DEC DH-11 interface. If other hardware is used, 
impossible speed changes are ignored. Symbolic values in the table are as defined in <8gtty.h> . 



BO 





(hang up dataphone) 


B50 


1 


50 baud 


B75 


2 


75 baud 


BilO 


3 


110 baud 


B134 


4 


134.5 baud 


B150 


5 


150 baud 


BiHM) 


6 


200 baud 


B300 


7 


300 baud 


B600 


8 


600 baud 


B1200 


9 


1200 baud 


B18CK) 


10 


1800 baud 


B2400 


11 


2400 baud 


B4800 


12 


4800 baud 


B9600 


13 


9600 baud 


EXTA 


14 


External A 


EXTB 


15 


External B 



In the current configuration, only 110, 150, 300 and 1200 baud are really supported on dial-up 
lines. Code conversion and line control required for IBM 2741's (134.5 baud) must be imple- 
mented by the user's program. The half-duplex line discipline required for the 202 dataset (1200 
baud) is not supplied; full-duplex 212 datasets work fine. 

The sg^erase and sgjnll fields of the argument structure specify the erase and kill characters 
respectively. (Defaults are DELETE and *U.) 

The 8g_Jlag8 field of the argument structure contains several bits that determine the system's 
treatment of the terminal: 



ALLDELAY 0177400 Delay algorithm selection 


BSDELAY 


0100000 Select backspace delays (not implemented): 


BSO 





BSl 


0100000 


VTDELAY 


0040000 Select form-feed and vertical-tab delays: 


FFO 





FFl 


0100000 


CRDELAY 


0030000 Select carriage-return delays: 


CRO 





CRl 


0010000 


CR2 


0020000 


CR3 


0030000 


TBDELAY 


0006000 Select tab delays: 


TABO 





TABl 


0001000 


TAB2 


0004000 


XTABS 


0006000 
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NLDELAY 0001400 Select new-line delays: 

NLO 

NLl 0000400 

NL2 0001000 

NL3 0001400 

EVENP 0000200 Even parity allowed on input (most terminals) 

ODDP 0000100 Odd parity allowed on input 

RAW 0000040 Raw mode: wake up on all characters, 8-bit interface 

CRMOD 0000020 Map CR into LF; echo LF or CR as CR-LF 

ECHO 0000010 Echo (full duplex) 

LCASE 0000004 Map upper case to lower on input 

CBREAK 0000002 Return each character as soon as typed 

TANDEM 0000001 Automatic flow control 

The delay bits specify how long transmission stops to allow for mechanical or other movement 
when certain characters are sent to the terminal. In all cases a value of indicates no delay. 

Backspace delays are currently ignored but might be used for Terminet 300's. 

If a form-feed/ vertical tab delay is specified, it lasts for about 2 seconds. 

Carriage-return delay type 1 lasts about .08 seconds and is suitable for the Terminet 300. Delay 
type 2 lasts about .16 seconds and is suitable for the VT05 and the TI 700. Delay type 3 is suit- 
able for the concept-100 and pads lines to be at least 9 characters at 9600 baud. 

New-line delay type 1 is dependent on the current column and is tuned for Teletype model ST's. 
Type 2 is useful for the VT05 and is about .10 seconds. Type 3 is unimplemented and is 0. 

Tab delay type 1 is dependent on the amount of movement and is tuned to the Teletype model 
37. Type 3, called XTABS, is not a delay at all but causes tabs to be replaced by the appropriate 
number of spaces on output. 

Input characters with the wrong parity, as determined by bits 200 and 1(X), are ignored in cooked 
and CBREAK mode. 

RAW disables all processing save output flushing with LFLUSHO; full 8 bits of input are given as 
soon as it is available; all 8 bits are passed on output. A break condition in the input is reported 
as a null character. If the input queue overflows in raw mode it is discarded; this applies to both 
new and old drivers. 

CRMOD causes input carriage returns to be turned into new-lines; input of either CR or LF 
causes LF-CR both to be echoed (for terminals with a new-line function). 

CBREAK is a sort of half-cooked (rare?) mode. Programs can read each character as soon as 
typed, instead of waiting for a full line; all processing is done except the input editing: character 
and word erase and line kill, input reprint, and the special treatment of \ or EOT are disabled. 

TANDEM mode causes the system to produce a stop character (default *S) whenever the input 
queue is in danger of overflowing^ and a start character (default 'Q) when the input queue has 
drained sufficiently. It is useful for flow control when the 'terminal' is really another computer 
which understands the conventions. 

Basic ioctls 

In additidn to the TIOCSETD and TIOCGETD disciplines discussed in Line diBclpUnea above, a 
large number of other ioctl(2) calls apply to terminals, and have the general form: 

#include <8gtty.h> 

ioctl(iilde8, code, arg) 
struct sgttyb *arg; 
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The applicable codes are: 

TIOCGETP Fetch the basic parameters associated with the terminal, and store in the 
pointed-to sgttyb structure. 

TIOCSETP Set the parameters according to the pointed-to sgttyb structure. The interface 

delays until output is quiescent, then throws away any unread characters, before 
changing the modes. 

TIOCSETN Set the parameters like TIOCSETP but do not delay or flush input. Input is not 
preserved, however, when changing to or from RAW. 

With the following codes the arg is ignored. 

TIOCEXCL Set "exclusive-use" mode: no further opens are permitted until the file has been 
closed. 

TIOCNXCL Turn off "exclusive-use" mode. 

TIOCHPCL When the file is closed for the last time, hang up the terminal. This is useful 
when the line is associated with an ACU used to place outgoing calls. 

TIOCFLUSH All characters waiting in input or output queues are flushed. 

The remaining calls are not available in vanilla version 7 UNIX. In cases where arguments are 
required, they are described; arg should otherwise be given as 0. 

TIOCSTI the argument is the address of a character which the system pretends was typed 

on the terminal. 

TIOCSBRK the break bit is set in the terminal. 

TIOCCBRK the break bit is cleared. 

TIOCSDTR data terminal ready is set. 

TIOCCDTR data terminal ready is cleared. 

TIOCGPGRP arg is the address of a word into which is placed the process group number of the 
control terminal. 

TIOCSPGRP arg is a word (typically a process id) which becomes the process group for the 
control terminal. 

FIONRE^AD returns in the long integer whose address is arg the number of immediately read- 
able characters from the argument unit. This works for files, pipes, and termi- 
nals. 

The second structure associated with each terminal specifies characters that are special in both 
the old and new terminal interfaces: The following structure is defined in <8yslioctLh> , which is 
automatically included in <8gtty.h>: 

struct tchars { 

/♦ Interrupt */ 

/♦ quit */ 

/* stiurt output */ 

/* stop output */ 

/* end-of-flle */ 

/* Input delimiter (like nl) */ 



char 


t_lntrcj 


char 


tjqultc; 


char 


t_8tartc| 


char 


tjitopc; 


char 


tjeofcj 


char 


tjbrkci 



The default values for these characters are *C, *\, "Q, 'S, "D, and -1. A character value of -1 
eliminates the effect of that character. The tjbrkc character, by default -1, acts like a new-line in 
that it terminates a 'line,' is echoed, and is passed to the program. The 'stop' and 'start' charac- 
ters may be the same, to produce a toggle effect. It is probably counterproductive to make other 
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special characters (including erase and kill) identical. The applicable ioctl calls are: 

TIOCGETC Get the special characters and put them in the specified structure. 

TIOCSETC Set the special characters to those given in the structure. 

Local mode 

The third structure associated with each terminal is a local mode word; except for the 
LNOHANG bit, this word is interpreted only when the new driver is in use. The bits of the local 
mode word are: 

LOR TBS 000001 Backspace on erase rather than echoing erase 

LPRTERA 000002 Printing terminal erase mode 

LCRTERA 000004 Erase character echoes as backspace-space-backspace 

LTILDE 000010 Convert ~ to ' on output (for Hazeltine terminab) 

LMDMBUF 000020 Stop /start output when carrier drops 

LLITOUT 000040 Suppress output translations 

LTOSTOP 000100 Send SIGTTOU for background output 

LFLUSHO 000200 Output is being flushed 

LNOHANG 000400 Don't send hangup when carrier drops 

LETXACK 001000 Diablo style buffer hacking (unimplemented) 

LCRTKIL 002000 BS-space-BS erase entire line on line kill 

LCTLECH 010000 Echo input control chars as *X, delete as *? 

LPENDIN 020000 Retype pending input at next read or input character 

LDECCTQ 040000 Only *Q restarts output after *S, like DEC systems 

The applicable ioctl functions are: 

TIOCLBIS arg is the address of a mask which is the bits to be set in the local mode word. 

TIOClfBIC arg is the address of a mask of bits to be cleared in the local mode word. 

TIOCLSET arg is the address of a mask to be placed in the local mode word. 

TIOCLGET arg is the address of a word into which the current mask is placed. 

Local special chars 

The final structure associated with each terminal is the Itchara structure which defines interrupt 
characters for the new terminal driver. Its structure is: 



/* stop process signal */ 

I* delayed stop process signal */ 

/* reprint line */ 

/* flusli output (toggles) */ 

/* word erase */ 

/* literal next character */ 

The default values for these characters are *Z, *Y, *R, *0, *W, and *V. A value of -1 disables 
the character. 

The applicable ioctl functions are: 

TIOCSLTC args is the address of a Itchara structure which defines the new local special charac- 
ters. 

TIOCGLTC args b the address of a Itchars structure into which b placed the current set of local 
special characters. 
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'{ 


char 


t_suspc; 


char 


t_dsuspc} 


char 


t_rprntcj 


char 


tjQuBhe; 


char 


t_werascj 


char 


t„lnextc; 


}; 
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FILES 

/dev/tty 

/dev/tty* 

/dev/console 

SEE ALSO 

csh(l), 8tty(l), ioctl(2), 8igvec(2), stty(3C), getty(8), init(8) 

BUGS 

Half-duplex terminals are not supported. 
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NAME 

udp - Internet User Datagram Protocol 

SYNOPSIS 

None; comes automatically with inet(4F), 

DESCRIPTION 

The User Datagram Protocol (UDP) is defined to make available a datagram mode of packet 
switched computer communicaton in the environment of an interconnected set of computer net- 
works. The protocol assumes that the Internet Protocol (IP) as described in tp(4P) is used as the 
underlying protocol. 

The protocol provides a procedure for application programs to send messages to other programs 
with a minimum of protocol mechanism. The protocol is transaction oriented, and delivery and 
duplicate protection are not guaranteed. Applications requiring ordered reliable delivery of 
streams of data should use the Transmission Control Protocol (TCP) as described in tcp{4P), 

The UNIX implementation of UDP makes it available as a socket of type SOCKJ)GRAM. UDP 
sockets are normally used in a connectionless fashion, with the sendto and recvfrom calls described 
in 8end{2) and recv{2). 

A UDP socket is created with a 8ocket(2) call: 

■ = socket(AFJNET, SOCK_DGRAM, 0)| 

The socket initially has no address associated with it, and may be given an address with a bind{2) 
call as described in tne{(4F). If no bind call is done, then the address assignment procedure 
described in inet(4F) is repeated as each datagram is sent. 

When datagrams are sent the system encapsulates the user supplied data with UDP and IP 
headers. Unless the invoker is the super-user datagrams which would become broadcast packets 
on the network to which they are addressed are not allowed. Unless the socket has had a 
SO_DONTROUTE option enabled (see 8ocket{2)) the outgoing datagram is routed through the 
routing tables as described in routing{4N). If there is insufficient system buffer space to tem- 
porarily hold the datagram while it is being trasmitted, the sendto may result in a ENOBUFS 
error. Other errors (ENETUNREACH, EADDRNOTAVAIL, EACCES, EMSGSIZE) may be gen- 
erated by icmp(4P) or by the network interfaces themselves, and are reflected back in the send 
call. 

As each UDP datagram arrives at a host the system strips out the IP options and checksums the 
data field, discarding the datagram if the checksum indicates that the datagram has been dam- 
aged. If no socket exists for the datagram to be sent to then an ICMP error b returned to the 
originating socket. If a socket exists for this datagram to be sent to, then we will append the 
datagram and the address from which it came to a queue associated with the datagram socket. 
This queue has limited capacity (2048 bytes of datagrams) and arriving datagrams which will not 
fit within its high- water capacity are silently discarded. 

UDP processes ICMP errors reflected to it by icmp{4P). QUENCH errors are ignored (this is well 
considered a bug); UNREACH, TIMXCEED and PARAMPROB errors cause the socket to be 
disconnected from its peer if it was bound to a peer using bind{2) so that subsequent attempts to 
send datagrams via that socket will give an error indication. 

The UDP datagram protocol differs from IP datagrams in that it adds a cliecksum over the data 
bytes and contains, a 16-bit socket address on each machine rather than just the 32>bit machine 
address; UDP datagrams are addressed to sockets; IP packets are addressed to hosts. 

SEE ALSO 

recv(2), send(2), inet(4F) 

"User Datagram Protocol", RFC768, John Postel, USC-ISI (Sun 800-1054-01) 



60 Last change: 17 August 1983 Sun Release 1.1 



UDP(4P) SPECIAL FILES UDP(4P) 



BUGS 

SIOCSHIWAT and SIOCGHIWAT ioctl's to set and get the high water mark for the socket 
queue, and so that it can be changed from 2048 bytes to be larger or smaller, have been defined 
(in <sys/ioctl.h>) but not implemented. 

Something sensible should be done with QUENCH errors if the socket is bound to a peer socket. 
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NAME 

vp - Ikon 10071-5 Multibus Versatec parallel printer interface 

SYNOPSIS 

device vpO at mbO ear 0x400 priority 2 

DESCRIPTION 

The Sun Multibus interface to the Versatec printer /plotter is supported by the Ikon parallel inter- 
face board, a word DMA device, which is output only. 

The Versatec is normally handled by the line printer spooling system and should not be accessed 
by the user directly. 

Opening the device jdev/vpO may yield one of two errors: ENXIO indicates that the device is 
already in use. EIO indicates that the device is offline. 

The printer operates in either print or plot mode. To set the printer into plot mode you should 
include <vcmd.h> and use the ioctl{2) call 

ioctl(f, VSETSTATE, plotmd); 

where plotmd is defined to be 

int plotmdjl =- { VPLOT, 0, }; 

When going back into print mode from plot mode you normally eject paper by sending it an EOT 
after putting into print mode: 

int prtmdjl = { VPRINT, 0, }; 

fflush(vp); 

ioctl(f, VSETSTATE, prtmd); 

write(f, ''\04", 1); 

FILES 

/dev/vpO 

SEE ALSO 

Multibus/Versatec Interface, Ikon Corp (Includes Versatec Manual) (Sun 800-1065-01) 



BUGS 



If you use the standard i/o library on the Versatec, be sure to explicitly set a buffer using setbuf, 
since the library will not use buffered output by default, and will run very slowly. 

This driver is not supported. 

Writes must start on even byte boundaries and be an even number of bytes in length. 
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NAME 

vpc - Systech VPC-2200 Versatec printer/plotter and Centronics printer interface 

SYNOPSIS 

device vpcO at mbO csr 0x480 priority 2 

DESCRIPTION 

The Sun Multibus interface to the Versatec printer/plotter and to Centronics printers is sup- 
ported by the Systech parallel interface board, an output-only byte-wide DMA device. The device 
has one channel for Versatec devices and one channel for Centronics devices, with an optional 
long lines interfause for Versatec devices. 

Devices attached to this interface are normally handled by the line printer spooling system and 
should not be accessed by the user directly. 

Opening the devices /dev/vpO /dev/lpO may yield one of two errors: ENXIO indicates that the 
device is already in use. EIO indicates that the device is offline. 

The Versatec printer /plotter operates in either print or plot mode. To set the printer into plot 
mode you should include <vcmd.h> and use the iocU{2) call: 

ioctl(f, VSETSTATE, plotmd); 

where plotmd is defined to be 

int plotmdl 1 == { VPLOT, 0, }; 

When going back into print mode from plot mode you normally eject paper by sending it an EOT 
after putting into print mode: 

int prtmdl J « { VPRINT, 0, }; 

fflush(vpc); 

ioctl(f, VSETSTATE, prtmd); 

write(f, ''\04M); 

FILES 

/dev/vpO 
/dev/lpO 

SEE ALSO 

Systech VPC-2200 Versatec Printer/Plotter Controller Technical Manual 

BUGS 

If you use the standard I/O library on the Versatec, be sure to explicitly set a buffer using setbuf, 
since the library will not use buffered output by default, and will run very slowly. 

Currently only 8 bit I/O is supported in the driver, even though the device supports 16 bit I/O. 
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NAME 

win - Sun window system 

SYNOPSIS 

pseudo-device win 128 
pseudo-device dtop4 

DESCRIPTION 

The win device accesses the system drivers supporting the Sun window system. 

Each window in the system is represented by a /dev/win* device. The windows are organized as 
a tree with windows being subwindows of their parents, and covering/covered by their siblings. 
Each window has a position in the tree, a position on a display screen, an input queue, and infor- 
mation telling what parts of it are exposed. 

The window driver multiplexes keyboard and mouse input among the several windows, tracks the 
mouse with a cursor on the screen, provides each window access to information about what parts 
of it are exposed, and notifies the manager process for a window when the exposed area of the 
window changes so that the window may repair its display. 

The dtop4 pseudo device line in a kernel configuration file indicates the number of separate 
"desktops" (frame buffers) that can be actively running the Sun window system at once. 

Full information on the window system functions is given in the Programmer's Reference Manual 
for SunWindowa. 

FILES 

/dev/win(0-9l 
/dev/win|0-9l|0-9l 

SEE ALSO 

Programmer's Reference Manual for SunWmdows 
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NAME 

xy - Disk driver for Xylogics SMD Disk Controllers 

SYNOPSIS 

controller xycO at mbO csr 0xee40 priority 2 
disk 3^0 at xycO drive 
dbk 3£yl at xycQ drive 1 

DESCRIPTION 

Files with minor device numbers through 7 refer to various portions of drive 0; minor devices 8 
through 15 refer to drive 1, and so on. The standard device names begin with "xy" followed by 
the drive number and then a letter a-h for partitions 0-7 respectively. The character ? stands 
here for a drive number in the range 0'7. 

The block Sle's access the disk via the system's normal buffering mechanism and may be read and 
written without regard to physical disk records. There is also a 'raw' interface which provides for 
direct transmission between the disk and the user's read or write buffer. A single read or write 
call results in exactly one I/O operation and therefore raw I/O is considerably more effficient 
when many words are transmitted. The names of the raw files conventionally begin with an extra 
•r.' 

In raw I/O counts should be a multiple of 512 bytes (a disk sector). Likewise seek calls should 
specify a multiple of 512 bytes. 

DISK SUPPORT 

This driver handles all SMD drives, by reading a label from sector of the drive which describes 
the disk geometry and partitioning. 

The xy?a partition is normally used for the root file system on a disk, the xy?b partition as a pag- 
ing area, and the xy?c partition for pack-pack copying (it normally maps the entire disk). The 
rest of the disk is normally the xy?h partition. 

FILES 

/dev/xy[0-7](arhl block files 

/dev/rxy[0-7]|a-hl raw files 

SEE ALSO 

dkio(4S), xy(4S) 

Xylogics Model 440 Peripheral Processor SMD Disk Subsystem Maintenance and Reference 

Manual (Sun 800-1005-01) 

Xylogics Model 450 Peripheral Processor SMD Disk Subsystem Maintenance and Reference 

Manual (Sun 800-102&-01) 

DIAGNOSTICS 

xye%dt self test error %x - %n. Self test error in controller, see the Maintenance and Refer- 
ence Manualo 

xye%ds address mode Jumper is wrong. The controller is strapped for 24-bit Multibus 
addresses; the Sun uses 20-bit addresses. See the Hardware Configuration and Expansion section 
of the System Manager's Manual for your Sun Workstaiton for instructions on setting the jumpers 
on the 450. 

xyattaeht can*t get bad sector info. The bad sector forwarding information for the disk, 
which is kept on the last cylinder, could not be read. 

xy%ds drive type %d clash with xy%d. The 450 does not support mixing the drive types 
found on these units on a single controller. 

xy%dt initialisation fidled. 
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xy%dt error %x reading label on head %d. Error reading drive geometry /partition table 
information. 

xy%dx Corrupt label. The geometry/partition label checksum was incorrect. 

xy%di Unsupported phys partition # %d. 

xy%d: offline. 

xy%d%ct cmd how (mag) blk %d. A command such as read, write, or format encountered a 
error condition (how): either it failed, the unit was restored, or an operation was retrj/ed. The 
tnsg is derived from the error number given by the controller, indicating a condition such as 
•'drive not ready", "sector not found" or "disk write protected". 

BUGS 

In raw I/O read and write{2) truncate file offsets to 512-byte block boundaries, and write scribbles 
on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, read, 
write and l8eek{2) should always deal in 512-byte multiples. 
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NAME 

ZS - ziiog 8530 sec serial comunications driver 

SYNOPSIS 

device ssO at mbO car OxfSaOOO flags 3 priority 5 

DESCRIPTION 

The Zilog 8530 provides 2 serial communication lines with full modem control. Each line behaves 
as described in tty{4). Input and output for each line may independently be set to run at any of 
16 speeds; see tty(4) for the encoding. 

FILES 

/dev/ttyjardj 

SEE ALSO 

tty(4) 

Zilog Z8030/Z8530 SCC Serial Communications Controller (Sun 800-1052-01) 

DIAGNOSTICS 

ss%cl%ei silo overflow. The character input silo overflowed before it could be serviced. 
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NAME 

a.out - assembler and link editor output 

SYNOPSIS 

#iiiclude <a.out.h> 
#lnclude <stab.h> 
#include <nllBt.h> 

DESCRIPTION 

A.out is the output file of the assembler a9(lS) and the link editor id{l). The latter makes a.out 
executable if there were no errors and no unresolved external references. Layout information as 
given in the include file for the Sun system is: 

/• 

* Header prepended to each a.out file. 

*/ 

struct exec { 

long a_magic; /* magic number */ 

unsigned a_text; /* size of text segment */ 

unsigned a_data; /* size of initialized data */ 

unsigned a_b88; /* size of uninitialized data */ 

unsigned ajsyms; /* size of symbol table */ 

unsigned ajentry; /* entry point */ 

unsigned a_trsize; /* size of text relocation */ 

unsigned ajdrsize; /* size of data relocation */ 

}.• 

#define OMAGIC 0407 /* old impure format */ 

#define NMAGIC 0410 /* read-only text */ 
#define ZMAGIC 0413 /* demand load format */ 

#define PAGSIZ 2048 
#define SEGSIZ 0x8000 
#defin6 TXTRELOC SEGSIZ 

/* 

* Macros which take exec structures as arguments and tell whether 

* the file has a reasonable magic number or offsets to text | symbols | strings. 

*/ 
#define N3ADMAG(x) \ 

(((x).ajnagic)!=OMAGIC && ((x).a_magic)!=NMAGIC && ((x).a_magic)!=ZMAGIC) 

#define N_TXTOFF(x) \ 

((x).a_magic==ZMAGIC ? PAGSIZ : sizeof (struct exec)) 
#define N_SYMOFF(x) \ 

(N_TXTOFF(x) + (x).a_text+ (x).a_data + (x).a_trsize+ (x).a_drsize) 
#define N_STROFF(x) \ 

(N SYMOFF(x) + (x).aj5yms) 

/* 

* Macros which take exec structures as arguments and tell where the 

* various pieces will be loaded. 

*/ 

#define N_TXTADDR(x) TXTRELOC 
#define N_DATADDR(x) \ 

(((x).a_magic==OMAGIC)? (N_TXTADDR(x)+ (x).a_text) \ 

: (SEGSIZ+ ((N_TXTADDR(x)+ (x).a_text-l) & "SEGRND))) 
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#define N_BSSADDR(x) (N_DATADDR(x)+ (x).a_data) 

The a.out file has five sections: a header, the program text and data, relocation information, a 
symbol table and a string table (in that order). The last three may be omitted if the program was 
loaded with the '-s' option of Id or if the symbols and relocation have been removed by 8trip{l). 

In the header the sizes of each section are given in bytes. The size of the header is not included 
in any of the other sizes. 

When an a.out file is executed, three logical segments are set up: the text segment, the data seg- 
ment (with uninitialized data, which starts off as all 0, following initialized data), and a stack. 
The header is not loaded with the text segment. If the magic number in the header is OMAGIC 
(0407), it means that this is a non-sharable text which is not to be write-protected, so the data 
segment is immediately contiguous with the text segment. This is rarely used. If the magic 
number is NMAGIC (0410) or ZMAGIC (0413), the data segment begins at the first segment 
boundary following the text segment, and the text segment is not writable by the program; other 
processes executing the same file will share the text segment. For ZMAGIC format, the text seg- 
ment begins on a page boundary in the a.out file; the remaining bytes after the header in the first 
block are reserved and should be zero. In this case the text and data sizes must both be multiples 
of the page size, and the pages of the file will be brought into the running image as needed, and 
not pre-loaded as with the other formats. This is especially suitable for very large programs and 
is the default format produced by id{l). The macros N_TXTADDR, N_DATADDR, and 
NJBSSADDR give the core addresses at which the text, data, and bss segments, respectively, will 
be loaded. 

The stack starts at the highest possible location in the memory image, and grows downwards. 
The stack is automatically extended as required. The data segment is extended as requested by 
brk{2) or 8brk{2). 

After the header in the file follow the text, data, text relocation data relocation, symbol table and 
string table in that order. The text begins at byte PAGSIZ in the file for ZMAGIC format or just 
after the header for the other formats. The N_TXTOFF macro returns this absolute file position 
when given the name of an exec structure as argument. The data segment is contiguous with the 
text and immediately followed by the text relocation and then the data relocation information. 
The symbol table follows all this; its position is computed by the N_SYMOFF macro. Finally, 
the string table immediately follows the symbol table at a position which can be gotten easily 
using N_STROFF. The first 4 bytes of the string table are not used for string storage, but rather 
contain the size of the string table; this size INCLUDES the 4 bytes, the minimum string table 
size is thus 4. . . 

RELOCATION 

The value of a byte in the text or data which is not a portion of a reference to an undefined 
external symbol is exactly that value which will appear in memory when the file is executed. If a 
byte in the text or data involves a reference to an undefined external symbol, as indicated by the 
relocation information, then the value stored in the file is an offset from the associated external 
symbol. When the file is processed by the link editor and the external ^mbol becomes defined, 
the value of the symbol b added to the bytes in the file. 

If relocation information is present, it amounts to eight bytes per relocatable datum as in the fol- 
lowing structure: 

/♦ 
* Format of a relocation datum. 

V 

struct relocationjnfo { 

int r_address; /* address which is relocated */ 
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unsigned rj5ymbolnum:24, /* locaJ symbol ordinal */ 

r_j)crel:l, /* was relocated pc relative already */ 

rjengtli:2, /* 0=byte, l=word, 2=long */ 

rjextern:!, /* does not include value of sym referenced */ 

:4; /* nothing, yet */ 

}; 

There is no relocation information if a_trsize+ a_drsize==0. If r_extern is 0, then rjsymbolnum 
is actually a n_type for the relocation (i.e. N_TEXT meaning relative to segment text origin.) 

SYMBOL TABLE 

The layout of a symbol table entry and the principal flag values that distinguish symbol types are 
given in the include file as follows: 

/• 
* Format of a i^mbol table entry. 

V 

struct nlist { 

union { 

char *n_name; /* for use when in-memory */ 

long njstrx; /* index into file string table */ 
} n_un; 

unsigned char n_type; /* type flag, i.e. NJTEXT etc; see below */ 

char n_other; 

short n_desc; /* see <stab.h> */ 

unsigned njvalue; /* value of this symbol (or adb offset) */ 



}; 



#define n_hash 


n_de! 


* Simple values for n_type. 


#define N_UNDF 


0x0 


#define N_ABS 


0x2 


#define N.TEXT 


0x4 


#define N DATA 


0x6 


#define N.BSS 


0x8 


#definc N_COMM 


0x12 


#definc N_FN 


Oxlf 


#define N_EXT 


01 


#deflne N_TYPE 


Oxle 



n_desc /* used internally by Id */ 



/* undefined */ 

/* absolute */ 

/♦ text */ 

/* data */ 

/* bss ♦/ 

/* common (internal to Id) */ 

/* file name symbol */ 

/* external bit, or'ed in */ 
/* mask for all the type bits */ 

/* 

* Other permanent symbol table entries have some of the N_STAB bits set. 

* These are given in <stab.h> 

*/ 
#define N_STAB OxeO /* if any of these bits set, don't discard */ 

In the a.out file a symbol's n_un.n_strx field gives an index into the string table. A njstrx value 
of indicates that no name is associated with a particular symbol table entry. The field 
n_un.n_name can be used to refer to the symbol name only if the program sets this up using 
njstrx and appropriate data from the string table. Because of the union in the nlist declaration, 
it is impossible in C to statically initialize such a structure. If this must be done (as when using 
nl%8t{Z)) the file <nli8t.h> should be included, rather that <a.out.h>; this contains the 
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declaration without the union. 

If a symbors type is undefined external, and the value field is non-zero, the symbol is interpreted 
by the loader Id as the name of a common region whose size is indicated by the value of the sym- 
bol. 

STAB SYMBOLS 

Stab.h defines some values of the n_type field of the symbol table of a.out files. These are the 
types for permanent symbols (that is, not local labels, etc.) used by the debuggers adb{lS) and 
dbx{l) and the Berkeley Pascal compiler pc{l). Symbol table entries can be produced by the 
.staba assembler directive. This allows one to specify a double-quote delimited name, a symbol 
type, one char and one short of information about the symbol, and an unsigned long (usually an 
address). To avoid having to produce an explicit label for the address field, the .etabd directive 
can be used to implicitly address the current location. If no name is needed, symbol table entries 
can be generated using the .stabn directive. The loader promises to preserve the order of symbol 
table entries produced by .stab directives. 

The n.value field of a symbol is relocated by the link editor as an address within the appropriate 
segment. N^value fields of symbols not in any segment are unchanged by the linker. In addition, 
the linker will discard certain symbols, according to rules of its own, unless the n_type field has 
one of the bits masked by N_STAB set. 

This allows up to 112 (7 * 16) symbol types, split between the various segments. Some of these 
have already been claimed. The debugger, adb{lS), uses the following n_type values: 

* global symbol: name„0,type,0 */ 

* procedure name (f77 kludge): name„0 */ 

* procedure: name„0,linenumber,addres8 */ 

* static symbol: name„0,type,address */ 

* .Icomm symbol: name„0,type,address */ 

* register sym: name„0,type,register */ 

* src line: 0„0,linenumber,address */ 

* structure elt: name„0,type,struct_offset */ 

* source file name: name,,0,0,address */ 

* local sym: name„0,type,offset */ 

* #included file name: name„0,0,address */ 

* parameter: name„0,type,offset */ 

* alternate entry: name,linenumber,address */ 

* left bracket: 0,,0,nesting level,address */ 

* right bracket: 0„0,nesting level,address */ 

* begin common: name,, */ 

* end common: name,, */ 

* end common (local name): „addres8 */ 

* second stab entry with length information */ 

where the comments give the adb conventional use for .stabs &nd the n_name, njother, n_desc, 
and n_value fields of the given n_type. Adb uses the n_desc field to hold a type specifier in the 
form used by the Portable C Compiler, cc(l), in which a base type is qualified in the following 
structure: 

struct desc { 

short q6:2, 
q5:2, 

q4:2, ^ 
q3:2, 
q2:2, 
ql:2, 



#define N_GSYM 0x20 
#define N^FNAME 0x22 
#define N_FUN 0x24 
#define N_STSYM 0x26 
#define N_LCSYM 0x28 
#define N_RSYM 0x40 
#define N_SLINE 
#define N_SSYM 
#define N_SO 
#define NJLSYM 
#define N_SOL 
#define N_PSYM 
#define N_ENTRY 0xa4 
#define N_LBRAC OxcO 
#define NJIBRAC OxeO 
#define N_BCOMM0xe2 
#define N_ECOMM0xe4 
#define NJECOML 0xe8 
#define N_LENG Oxfe 



0x44 
0x60 
0x64 
0x80 
0x84 
OxaO 
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basic :4; 

}; 

There are four qualifications, with ql the most significant and q6 the least significant: 

none 

1 pointer 

2 function 

3 array 

The sixteen basic types are assigned as follows: 

undefined 

1 function argument 

2 character 

3 short 

4 int 

5 long 

6 float 

7 double 

8 structure 

9 union 

10 enumeration 

11 member of enumeration 

12 unsigned character 

13 unsigned short 

14 unsigned int 

15 unsigned long 

The Berkeley Pascal compiler, pc{l), uses the following n_type value: 
#defineN_PC 0x30 /* global pascal symbol: name,,0,subtype,line */ 

and uses the following subtypes to do type checking across separately compiled files: 

1 source file name 

2 included file name 

3 global label 

4 global constant 

5 global type 

6 glob^ variable 

7 global function 

8 global procedure 

9 external function 

10 external procedure 

11 library variable 

12 library routine 

The new dbx{l) debugger uses an entirely different interpretation for the staba symbol-table 
entries. Currently, this is understood only by dbx and cc, but its use should supplant the current 
interpretation as soon 2ia adb and pc can be modified to use it. 

SEE ALSO 

adb(lS), as(lS), ld(l), nm(l), dbx(l), strip(l) 

BUGS 

There are currently two interpretations of the stabs symbol-table information. This creates great 
confusion when trying to build a program for debugging. 

Due to the amount of symbolic information necessary for high-level debugging, the whole a. out 
structure has been streched well beyond its original design, and should be replaced by something 
with a more sophisticated symbol-table mechanism. The demands of future languages will only 
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NAME 

aliases - aliases file for sendmail 

SYNOPSIS 

/usr/llb/aliases 

/ii8r/llb/al!aBe8.dlr 

/usr/lib/allases.pag 

DESCRIPTION 

These files describe user id aliases used by /usrf lib/ sendmail. /usr/ lib/ aliases is formatted as a 
series of lines of the form 

name: name_l, name2, name_3, . . . 
The name is the name to alias, and the name_n are the aliases for that name. Lines beginning 
with white space are continuation lines. Lines beginning with ' # ' are comments. 

Aliasing occurs only on local names. Loops can not occur, since no message will be sent to any 
person more than once. 

After aliasing has been done, local and valid recipients who have a ".forward" file in their home 
directory have messages forwarded to the list of users defined in that file. 

I usT I lib I aliases is only the raw data file; the actual aliasing information is placed into a binary 
format in the files f xisrjlibj alias es.dir and / usrf lib/ aliases.pag using the program newaliases(S). A 
newali&ses command should be executed each time that /usr/ lib/ aliases is changed for the change 

to take effect. 

Se^reral kinds of name's are special: 

owner-mary: fred 

any errors resulting from a mail to mary are directed to fred instead of back to the person 
who sent the message. This is most useful when mary is a mailing list rather than an 
individual. 

beer: :include:/usr/cyndi/beer; 

All colons and semicolons are required as shown. The list of names in / usr/ cyndi/ beer is 
included in the namejn list for the beer alias, in addition to any other names in the 
namejfi list. This mechanism is for setting up a mailing list so that /usr/ lib/ aliases 
doesn't have to be changed when people are added to or removed from the list. The 
included file (that is, /usr/ cyndi/ beer in this case) may be changed at any time, and 
changes take effect immediately. 

SEE ALSO 

newaliases(8), dbm(3X)^ sendmail(8) 
SENDMAIL Installation and Operation Guide. 
SENDNIaIL An Internetwork Mail Router. 



BUG3 



Because of restrictions in d6m(3X) a single alias cannot contain more than about 1000 bytes of 
information. You can get longer aliases by "chaining"; that is, make the last name in the alias be 
a dummy name which is a continuation alias. 
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NAME 

ar - archive (library) file format 

SYNOPSIS 

#include <ar.h> 

DESCRIPTION 

The archive command ar combines several files into one. Archives are used mainly as libraries to 
be searched by the link-editor Id. 

A file produced by ar has a magic string at the start, followed by the constituent files, each pre- 
ceded by a file header. The magic number and header layout as described in the include file are: 

/♦ ®(#)ar.h 1.1 83/08/01 SMI; from UCB 4.1 83/05/03*/ 

#defineARMAG ''!<arch>\n'' 
#define SARMAG 8 

#define ARFMAG '"\n'' 

struct ar3<ir { 

char ar_name[16|; 

char ar_date[l2]; 

char ar_uid|6|; 

char ar_gid[6|; 

char ar_model8); 

char arjsizejlOl; 

char arjrmag[2]; 

}; 

The name is a blank-padded string. The ar_fmag field contains ARFMAG to help verify the pres- 
ence of a header. The other fields are left-adjusted, blank-padded numbers. They are decimal 
except for arjmode, which is octal. The date is the modification date of the file at the time of its 
insertion into the archive. 

Each file begins on a even (0 mod 2) boundary; a new-line is inserted between files if necessary. 
Nevertheless the size given reflects the actual size of the file exclusive of padding. 

There is no provision for empty areas in an archive file. 

The encoding of the header is portable across machines. If an archive contains printable files, the 
archive itself is printable. 

SEE ALSO 

ar(l), ld(l), nm(l) 

BUGS 

File names lose trailing blanks. Most software dealing with archives takes even an included blank 
as a name terminator. 
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NAME 

core - fonnat of memory image file 

SYNOPSIS 

^Include <machSiie/param.h> 

DESCRIPTION 

The UNIX System writes out a memory image of a terminated process when any of various errors 
occur. See 8igvec{2) for the list of reasons; the most common are memory violations, illegal 
instructions, bus errors, and user-generated quit signals. The memory image is called 'core' and is 
written in the process's working directory (provided it can be; normal access controls apply). 

The maximum size of a core file is limited by 8etrlimit{2). Files which would be larger than the 
limit are not created. 

Set-user-id programs do not produce core files when they terminate as this would be a security 
loophole. 

The core file consists of the u. area, whose size (in pages) is defined by the UP AGES manifest in 
the < machine/ par am.h> file. The u. area starts with a user structure as given in 
<8y8/u8er,h>. The remainder of the core file consists first of the data pages and then the stack 
pages of the process image. The amount of data space image in the core file is given (in pages) by 
the variable u^daize in the u. area. The amount of stack image in the core file is given (in pages) 
by the vauriable u^ssize in the u. area. 

SEE ALSO 

adb(l), dbx(l), 8igvec(2), 8etrlimit(2) 
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NAME 

cpio - format of cpio archive 

DESCRIPTION 

The old format header structure, when the c option is not used, is: 

struct { 

short h.magic, 

h_dev, 

h_ino, 

h_mode, 

h_uid, 

h_^id, 

h.nlink, 

h_rdev, 

h_mtime(2], 

h_name8ize, 

h_filesizel2l; 
char h name{h_namesize rounded to a word]; 
}Hdr; 

but note that the byte order here is that of the PDP-11 and the VAX, and that for the Sun you 
have to use 8wab{3) after reading and before writing headers. 

When the c option is used, the header information is described by the statement below: 

sscanf(Chdr, ''%6o%6o%6o%6o%6o%6o%6o%6o%lllo%6o%6o%8'', 
&Hdr.h_magic, &Hdr.h_dev, &Hdr.h_ino, &Hdr.h_mode, 
&Hdr.h_uid, &Hdr.h_gid, &Hdr.h_nlink, &Hdr.h_rdev, 
&Hdr.h_mtime, &Hdr.h_namesize, &Hdr.h_flle8ize, &Hdr.h_name); 

Longtime and Longfile are equivalent to Hdr.h_mtime and Hdr.hJUesize, respectively. The con- 
tents of each file is recorded in an element of the array of varying length structures, archive, 
together with other items describing the file. Every instance of h_magic contains the constant 
070707 (octal). The items h_dev through h_jntime have meanings explained in 8tat{2). The 
length of the null-terminated path name h_name, including the null byte, is given by h^namesize. 

The last record of the archive always contains the name TRAE.ER!!!. Special files, directories, 
and the trailer, are recorded with h_JUe8ize equal to zero. 

SEE ALSO 

cpio(l), find(l), 8tat(2) 
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NAME 

crontab - table of times to run periodic jobs 

DESCRIPTION 

The /etc/cron utility is a permanent process, started by /etc/rc.local, that wakes up once every 
minute, /etc/cron consults the file /usr/iib/ crontab to find out what tasks are to be done, and at 
what time. 

Each line in /usr/ lib/ crontab consists of six fields, separated by spaces or tabs, as follows: 

1. minutes field, which can have values in the range through 59. 

2. hours field, which can have values in the range through 23. 

3. day of the month, in the range 1 through 31. 

4. month of the year, in the range 1 through 12. 

5. day of the week, in the range 1 through 7. Monday is day 1 in this scheme of things. 

6. (the remainder of the line ) is the command to be run. A percent character in this field is 
translated to a new-line character. Only the first line (up to a % or end of line) of the 
command field is executed by the Shell. The other lines are made available to the com- 
mand as standard input. 

Any of fields 1 through 5 can be a list of values separated by commas. A field can be a pair of 
numbers separated by a hyphen, indicating that the job is to be done for all the times in the 
specified range. If a field is an asterisk character (*) it means that the job is done for all possible 
values of the field. 

FILES 

/usr/Iib/crontab 

SEE ALSO 

cron(8), rc(8) 

EXAMPLE 

* * * calendar - 

15 * * * /etc/sa -s >/dev/null 

15 4 * * * find /usr/preserve -mtime + 7 -a -exec rm -f {} ; 

40 4 * * ♦ find / -name '#*' -atime + 3 -exec rm -f {} ; 

0,15,30,45 * * ♦ * /etc/atrun 

0,10,20,30,40,50 * * * ♦ /etc/dmesg - >>/usr/adm/me88ages 

5 4 * * * sh /etc/newsyslog 

The ealenaar command run at minute of hour (midnight) of every day. The /etc/aa command 
runs at 15 minutes after midnight every day. The two find commands run at 15 minutes past 
four and at 40 minutes past four, respectively, every day of the year. The atrun command (which 
processes shell scripts users have set up with at) runs every 15 minutes. The /etc/dmesg com- 
mand appends kernel messages to the /usr/adm/ messages file every ten minutes, and finally, the 
/ usr/ adm/ syslog script runs at five minutes after four every day. 
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NAME 

dir - format of directories 

SYNOPSIS 

#include <8ys/type8.h> 
#include <8y8/dir.h> 

DESCRIPTION 

A directory behaves exactly like an ordinary file, save that no user may write into a directory. 
The fact that a file is a directory is indicated by a bit in the flag word of its i-node entry; see 
/9(5). The structure of a directory entry as given in the include file is: 

/♦ 

* A directory consists of some number of blocks of DIRBLKSIZ 

* bytes, where DIRBLKSIZ is chosen such that it can be transferred 

* to disk in a single atomic operation (e.g. 512 bytes on most machines). 

* Each DIRBLKSIZ byte block contains some number of directory entry 

* structures, which are of variable length. Each directory entry has 

* a struct direct at the front of it, containing its inode number, 

* the length of the entry, and the length of the name contained in 

* the entry. These are followed by the name padded to a 4 byte boundary 

* with null bytes. All names are guaranteed null terminated. 

* The maximum length of a name in a directory is MAXNAMLEN. 

* The macro DIRSIZ(dp) gives the amount of space required to represent 

* a directory entry. Free space in a directory is represented by 

* entries which have dp->d_reclen > DIRSIZ(dp). All DIRBLKSIZ bytes 

* in a directory block are claimed by the directory entries. This 

* usually results in the last entry in a directory having a large 

* dp->d_reclen. When entries are deleted from a directory, the 

* space is returned to the previous entry in the same directory 

* block by increasing its dp->d_reclen. If the first entry of 

* a directory block is free, then its dp->d_ino is set to 0. 

* Entries other than the first in a directory do not normally have 

* dp->d_ino set to 0. 

*/ 

#ifdef KERNEL 

#define DIRBLKSIZ DEV_BSIZE 
#else 

#define DIRBLKSIZ 512 
#endif 

#define MAXNAMLEN 255 

/♦ 

* The DIRSIZ macro gives the minimum record length which will hold 

* the directory entry. This requires the amount of space in struct direct 

* without the d_name field, plus enough space for the name with a terminating 

* null byte (dp->d_namlen+ 1), rounded up to a 4 byte boundary. 

V 

#undef DIRSIZ 

#define DIRSIZ(dp) ((sizeof (struct direct) - (MAXNAMLEN+ 1)) + (((dp)->d_namlen+ 1 + 3|k 

struct direct { 
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ujong d_ino; 

short d_recleii; 

short djoamlen; 

char d_name[MAXNAMLEN + 1]; 

/* typically shorter */ 

}; 

struct _dirde8c { 

int ddjd; 

long dd_loc; 

long ddjsize; 

char dd_buf[DIRBLKSIZl; 

}; 

By convention, the first two entries in each directory are for '.' and '..'. The first is an entry for 
the directory itself. The second is for the parent directory. The meaning of '..' is modified for 
the root directory of the master file system ('7")> where '..' has the same meaning as '.'. 

SEE ALSO 

f8(5), readdir(3) 
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NAME 

dump, dumpdates - incremental dump format 

SYNOPSIS 

#include <sy8/types.h> 
#include <By8/lnode.h> 
#include <dumpre8tor.h> 

DESCRIPTION 

Tapes used by dump and re8tore{S) contain: 

a header record 

two groups of bit map records 

a group of records describing directories 

a group of records describing files 

The format of the header record and of the first record of each description as given in the include 
file <duinprestor.h> is: 

#defineNTREC 10 

#define MLEN 16 

#define MSIZ 4096 



#define TS_TAPE 


1 


#define TSJNODE 


2 


#define TS_BITS 


3 


#define TS.ADDR 


4 


#define TS_END 


5 


#define TS_CLRI 


6 


#deflne MAGIC 


(int) 60011 


#define CHECKSUM 


(int) 84446 


struct 


spcl { 






int 


c_type; 




time_t 


c_date; 




time_t 


c_ddate; 




int 


c_volume; 




daddr_t 


c_tapea; 




ino_t 


c_inumber; 




int 


c_magic; 




int 


c_checksum; 




struct 


dinode 




int 


c_count; 




char 


c_addr|BSIZE]; 


} spcl; 






struct 


idates { 






char 


id_name|16j; 




char 


idjincno; 


}; 


time_t 


id_ddate; 



c_dinode; 



#define DUMPOUTFMT "^-lOs %c ^s" /♦ for printf */ 

/* name, incno, ctime(date) */ 
#define DUMPINFMT " % 16s %c %| * \n|\n'' /* inverse for scanf */ 
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NTREC is the default number of 1024 byte records in a physical tape block, changeable by the b 
option to dump. MLEN is the number of bits in a bit map word. MSIZ is the number of bit map 
words. 

The TS_ entries are used in the c_type field to indicate what sort of header this is. The types and 
their meanings are as follows: 

TS^TAPE Tape volume label 

TSJNODE A file or directory follows. The c_dinode field is a copy of the disk in ode and con- 
tains bits telling what sort of file this is. 

TSJBITS A bit map follows. This bit map has a one bit for each inode that was dumped. 

TS_ADDR A subrecord of a file description. See c_addr below. 

TS_END End of tape record. 

TS_CLRI A bit map follows. This bit map contains a zero bit for all inodes that were empty 
on the file system when dumped. 

MAGIC All header records have this number in cjmagic. 

CHECKSUM Header records checksum to this value. 

The fields of the header structure are as follows: 

cjiype The type of the header. 

cjdate The date the dump was taken. 

c_ddate The date the file system was dumped from. 

c.volume The current volume number of the dump. 

c_tapea The current number of this (1024-byte) record. 

cjnumber The number of the inode being dumped if this is of type TSJNODE. 

c_jnagic This contains the value MAQIC above, truncated as needed. 

c.checksum This contains whatever value is needed to make the record sum to CHECKSUM. 

cjdinode This is a copy of the inode as it appears on the file system; see /9(5). 

c_count The count of characters in c_addr. 

c_addr An array of characters describing the blocks of the dumped file. A character is 

zero if the block associated with that character was not present on the file system, 
otherwise the character is non-zero. If the block was not present on the file sys- 
tem, no block was dumped; the block will be restored as a hole in the file. If there 
is not sufficient space in this record to describe all of the blocks in a file, 
TS_ADDR records will be scattered through the file, each one picking up where the 
last left off. 

Each volume except the last ends witli a tapemark (read as an end of file). The last volume ends 
with a TS_^ND record and then the tapemark. 

The structure idates describes an entry in the file fete (dump dates where dump history is kept. 
The fields of the structure are: 

id_name The dumped filesystem is '/dey/idjnam'. 

idjncno The level number of the dump tape; see dump{S). 

idjddate The date of the incremental dump in ^stem format see type8{5). 



FILES 



/etc/dumpdates 

SEE ALSO 

dump(8), restore(8), fs(5), type8(5) 

BUGS 

Should more explicitly describe format of dumpdates file. 
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NAME 

environ - user environment 

SYNOPSIS 

extern char **envlron{ 

DESCRIPTION 

An array of strings called the 'environment' is made available by exeeve{2) when a process begins. 
By convention these strings have the form 'namessva/ue*. The following names are used by vari- 
ous commands: 

PATH The sequence of directory prefixes that sh, time, ntce(l), etc., apply in searching for a 

file known by an incomplete path name. The prefixes are separated by ':'. The 
login{l) process sets PATH=:/usr/ucb.7bin:/usr/bin. 

HOME A user's login directory, set by hgin{l) from the password file pa8ewd{5). 

TERM The kind of terminal for which output is to be prepared. This information is used by 
commands, such as nr off or p/o/(lG), which may exploit special terminal capabilities. 
See /etc/termcap {termcap{b)) for a list of terminal types. 

SHELL The file name of the user's login shell. 

TERMCAP The string describing the terminal in TERM, or the name of the termcap file, see 

termcap{3),termcap(S), 

EXINIT A startup list of commands read by ex(i), edit{l), and vi{l). 

USER The login name of the user. 

Further names may be placed in the environment by the export command and 'name= value' 
arguments in eh{l), or by the setenv command if you use caA(l). Arguments may also be placed 
in the environment at the point of an execve{2). It is unwise to conflict with certain sh{l) vari- 
ables that are frequently exported by '.profile' files: MAIL, PSl, PS2, IFS. 

SEE ALSO 

csh(l), ex(l), login(l), sh(l), getenv(3), execve(2), system(3), termcap(3X), termcap(5) 
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NAME 

fcnt! - file control options 

DESCRIPTION 

#liiclude <fcnt!.h> 

DESCRIPTION 

The fcntl{2) function provides for control over open files. This include file describes requests and 
arguments to fcnti z,nd open{2) as shown below: 

/* ®(#)fcntl.h 1.2 83/12/08 SMI; from UCB 4.2 83/09/25 */ 

/* 

* Flag values accessible to open(2) and fcntl(2) 

* (The first three can only be set by open) 

*/ 

#define O^RDONLY 

#defineO_WRONLY 1 
#defineOJRDWR 2 

#define O^NDELAY FNDELAY /* Non-blocking I/O */ 

#define 0_APPEND FAFPEND /♦ append (writes guaranteed at the end) */ 

#ifndefF_DUPFD 
/* fcntl(2) requests */ 

#defineF_DUPFD /* Duplicate fildes */ 

#define F_GETFD 1 /* Get fildes flags */ 

#define F.SETFD 2 /* Set fildes flags ♦/ 

#defineF_GETFL 3 /• Get file fiags */ 

#define F_SETFL 4 /♦ Set file flags */ 

#defineF„GETOWN 5 /* Get owner */ 
#define F_SETOWN /♦ Set owner ♦/ 

/* flags for F^GETFL, F^SETFL- copied from <8ys/file.h> */ 
#define FNDELAY 00004 /* non-blocking reads */ 

#define FAFPEND 00010 /* append on each write */ 

#define FASYNC 00100 /* signal pgrp when data ready */ 

#fndif 

SEE ALSO 

fcntl(2), open(2) 
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NAME 

fs, mode - format of file system volume 

SYNOPSIS 

#liiclude <sy8/type8.h> 
#iiiclude <By8/fllsys.h> 
#include <Bys/inode.h> 

DESCRIPTION 

Every file system storage volume (disk, nine-track tape, for instance) has a common format for 
certain vital information. Every such volume is divided into a certain number of blocks. The 
block size is a parameter of the file system. Sectors to 15 on a file system are used to contain 
primary and secondary bootstrapping programs. 

The actual file system begins at sector 16 with the super block. The layout of the super block as 
defined by the include file <8y8/f8.h> is: 

#defineFS_MAGIC 0x011954 

/* linked list of file systems */ 

/* used for incore super blocks */ 

/* addr of super-block in filesys */ 

/* offset of cyl-block in filesys */ 

/* offset of inode-blocks in filesys */ 

/* offset of first data after eg */ 

/* cylinder group offset in cylinder */ 

/* used to calc mod fs_ntrak */ 

/* last time written */ 

/* number of blocks in fs */ 

/* number of data blocks in fs '"/ 

/* number of cylinder groups */ 

/* size of basic blocks in fs */ 

/* size of frag blocks in fs */ 

/* number of frags in a block in fs */ 



struct fs { 




struct 


fs *fsjink; 


struct 


fs *fs_rlink; 


daddr. 


t fs^sblkno; 


daddr_ 


t fs_cblkno; 


daddr_t fsjblkno; 


daddr_tfs_dblkno; 


long 


fs_cgoff8et; 


long 


fs_cgmask; 


time_t 


fs_time; 


long 


f8_8ize; 


long 


fs_d8ize; 


long 


f8_ncg; 


long 


fs_bsize; 


long 


fs_fsi7;e; 


long 


fsjrag; 



/* minimum percentage of free blocks */ 
/* num of ms for optimal next block */ 
/* disk revolutions per second */ 



/* these are configuration parameters */ 
long fs_minfree; 
long f8_rotdelay; 
long fs^rps; 
/* these fields can be computed from the others */ 

long f8_bmask; /* "blkoff" calc of blk offsets ♦/ 

long fsjmask; /* "fragoff" calc of frag offsets */ 

long f8_bsh;ft; /* "Iblkno" calc of logical blkno */ 

long fsjshift; /♦ "numfrags" calc number of frags */ 

/* these are configuration parameters */ 

long f8_maxcontig; /* max number of contiguous blks */ 

long fs_maxbpg; /♦ max number of blks per cyl group */ 

/* these fields can be computed from the others */ 

/* block to frag shift */ 

/* fsbtodb and dbtofsb shift constant */ 

/* actual size of super block */ 

/* csum block offset */ 

/* csum block number */ 

/* value of NINDIR ♦/ 

/* value of INOPB */ 

/* value of NSPF */ 

/* reserved for future constants */ 



long 


fs_fragshift; 


long 


f8_fsbtodb; 


long 


f8_sbsize; 


long 


f8_csmask; 


long 


f8_csshift; 


long 


fs_nindir; 


long 


fsjnopb; 


long 


fs_nspf; 


long 


fs_8parecon|6l; 
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/* sizes determined by number of cylinder groups and their sizes */ 

daddr_t fs^csaddr; /* blk addr of cyl grp summary area */ 

long f8_c8size; /* size of cyl grp summary area */ 

long fsjcgsize; /* cylinder group size */ 

/* these fields should be derived from the hardware */ 

long fs_ntrak; /* tracks per cylinder */ 

long fs_n8ect; /* sectors per track */ 

long fsjspc; /* sectors per cylinder */ 

/* this comes from the disk driver partitioning '*'/ 

long fs_ncyl; /* cylinders in file system */ 

/* these fields can be computed from the others *( 

long fs_cpg; /* cylinders per group */ 

long f8_ipg; /* inodes per group */ 

long f8_fpg; /* blocks per group * fs_frag */ 

/* this data must be re-computed after crashes */ 

struct csum fs_cstotal; /* cylinder summary information */ 
/* these fields are cleared at mount time */ 

char fs_fmod; /* super block modified flag */ 

char fs_clean; /* file system is clean flag */ 

char f8_ronly; /* mounted read-only flag */ 

char fs_flag8; /* currently unused flag */ 

char fsJsmntlMAXMNTLENJ; /* name mounted on */ 

/* these fields retain the current block allocation info */ 

long fs_cgrptor; /* last eg searched */ 

struct csum ♦f8_csp|MAXCSBUFSj;/* list of fs^cs info buffers */ 

long f8_cpc; /* cyl per cycle in postbl ♦/ 

short fsj)08tbl|MAXCPG](NRP0S|;/* head of blocks for each rotation */ 

long fsjmagic; /* magic number */ 

u_char f8jrotbl(l|; /* list of blocks for each rotation */ 

/* actually longer */ 

}; 

Each disk drive contains some number of file systems. A file system consists of a number of 
cylinder groups. Each cylinder group has inodes and data. 

A file system is described by its super-block, which in turn describes the cylinder groups. The 
super-block is critical data and is replicated in each cylinder group to protect against catastrophic 
loss. This is done at file system creation time and the critical super-block data does not change, 
so the copies need not be referenced further unless disaster strikes. 

Addresses stored in inodes are capable of addressing fragments of 'blocks'. File system blocks of 
at most size MAXBSIZE can be optionally broken into 2, 4, or 8 pieces, each of which is address- 
able; these pieces may be DEV_BSIZE, or some multiple of a DEV_BSIZE unit. 

Large files consist of exclusively large data blocks. To avoid undue wasted disk space, the last 
data block of a small file is allocated as only as many fragments of a large block as are necessary. 
The file system format retains only a single pointer to such a fragment, which is a piece of a sin- 
gle large block that has been divided. The size of such a fragment is determinable from informa- 
tion in the inode, using the "blksize(fs, ip, Ibn)" macro. 

The file system records space availability at the fragment level; to determine block availability, 
aligned fragments are examined. 

The root inode is the root of the file system. Inode can't be used for normal purposes and his- 
torically bad blocks were linked to inode 1, thus the root inode is 2 (inode 1 is no longer used for 
this purpose, however numerous dump tapes make this assumption, so we are stuck with it). The 
lost-f- found directory is given the next available inode when it is initially created by mkfa. 
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f8_minfree gives the minimum acceptable percentage of file system blocks which may be free. If 
the freelist drops below this level only the super-user may continue to allocate blocks. This may 
be set to if no reserve of free blocks is deemed necessary, however severe performance degradar 
tions will be observed if the file system is run at greater than 90% full; thus the default value of 
fsjminfree is 10%. 

Empirically the best trade-off between block fragmentation and overall disk utilization at a load- 
ing of 90% comes with a fragmentation of 4, thus the default fragment size is a fourth of the 
block size. 

Cylinder group related limits: Each cylinder keeps track of the availability of blocks at different 
rotational positions, so that sequential blocks can be laid out with minimum rotational latency. 
NRPOS is the number of rotational positions which are distinguished. With NRPOS 8 the reso- 
lution of the summary information is 2ms for a typical 3600 rpm drive. 

fsjrotdelay gives the minimum number of milliseconds to initiate another disk transfer on the 
same cylinder. It is used in determining the rotationally optimal layout for disk blocks within a 
file; the default value for fsjrotdelay is 2ms. 

Each file system has a statically allocated number of inodes. An inode is allocated for each N6PI 
bytes of disk space. The inode allocation strategy is extremely conservative. 

MAXEPG bounds the number of inodes per cylinder group, and is needed only to keep the struc- 
ture simpler by having the only a single variable size element (the free bit map). 

N.B.t MAXIPG must be a multiple of INOPB(fs). 

MINBSIZE is the smallest allowable block size. With a MINBSIZE of 4096 it is possible to create 
files of size 2 '32 with only two levels of indirection. MINBSIZE must be big enough to hold a 
cylinder group block, thus changes to (struct eg) must keep its size within MINBSIZE. MAXCPG 
is limited only to dimension an array in (struct eg); it can be made larger as long as that 
structure's size remains within the bounds dictated by MINBSIZE. Note that super blocks are 
never more than size SBSIZE. 

The path name on which the file system is mounted is maintained in fs^fsmnt. MAXMNTLEN 
defines the amount of space allocated in the super block for this name. The limit on the amount 
of summary information per file system is defined by MAXCSBUFS. It is currently parameterized 
for a maximum of two million cylinders. 

Pf r cylinder group information is summarized in blocks allocated from the first cylinder group's 
data blocks. These blocks are read in from fs_csaddr (size fs cssize) in addition to the super 
block. 

N.B.I sizeof (struct csum) must be a power of two in order for the "fs_cs" macro to work. 

Super block for a file system: MAXBPC bounds the size of the rotational layout tables and is lim- 
ited by the fact that the super block is of size SBSIZE. The size of these tables is Inversely pro- 
portional to the block size of the file system. The size of the tables is increased when sector sizes 
are not powers of two, as this increases the number of cylinders included before the rotational 
pattern repeats ( f8_cpc). The size of the rotational layout tables is derived from the number of 
bytes remaining in (struct fs). 

MAXBPG bounds the number of blocks of data per cylinder group, and is limited by the fact that 
cylinder groups are at most one block. The size of the free block table is derived from the size of 
blocks and the number of remaining bytes in the cylinder group structure (struct eg). 

Inode: The inode is the focus of all file activity in the UNIX file system. There is a unique inode 
allocated for each active file, each current directory, each mounted-on file, text file, and the root. 
An inode is 'named' by its device/i-number pair. For further information, see the include file 
<sy8/inode.h>. 
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NAME 

fstab - static information about the filesystems 

SYNOPSIS 

#lz&elude <f8tab.h> 

DESCRIPTION 

The file /etc/ fstab describes the file systems and swapping partitions on the local machine. It is 
created by the system administrator using a text editor and processed by commands which 
mount, unmount, check consistency of, dump and restore file systems, and by the system in pro- 
viding swap space. 

It consists of a number of lines of the form: 

f8j5pec:f8_file:f8j;ypc:fs_freq:fs_passno 
an example of which would be: 

/dev/xyOa.'/.'rw:!: 1 

The entries from Ihis file are accessed using the routines in getf8ent{3), which returns a structure 
of the following form: 

struct fstab { 

char *f8„8pec; /* block special device name */ 

char *f8_file; /* file system path prefix */ 

char *f8„type; /* rw,ro,sw or xx */ 

int f8_freq; /* dump frequency, in days */ 

int f8_j>a68no; /* pass number on parallel dump */ 

The lines in the file give for each file system or swap area on the local machine the disk partition 
it is contained in fsjspec and the directory on which it is to be mounted (unless it is a swap area) 
in fs^e. The fsjspec special file name is the block special file name, and not the character spe- 
cial file name which the rest of the entry refers to. If a program needs the character special file 
name, the program must create it by appending a "r" after the last "/" in the special file name. 

The fsjtype indicates whether it it to be read-only "ro", readable and writable "rw", or readable 
and writable subject to quotas "rq". It f8_type is "sw" then the special file is made available as a 
piece of swap space by the 8wapon(B) command at the end of the system reboot procedure. The 
fields other than f8_8pec and f8_type are not used in this case. If f8_type is "rq" then at boot time 
the file system is automatically processed by the quotacheck(8) command and disk quotas are then 
enabled with quotaon{S). File system quotas are maintained in a file "quotas", which is located 
at the root of the associated file system. If /?_<ype! is specified as "xx" the entry is ignored. This 
is useful to show disk partitions which are currently not used. 

The field f8_freq indicates how often each partition should be dumped by the dump{8) command 
(and triggers that commands w option which telk which file systems should be dumped). Most 
systems set the f8_Jreq field to 1 indicating that the file systems are dumped each day. 

The final field f8jpa88no is used by the disk consistency check program /?c*(8) to allow overapped 
checking of file systems during a reboot. All file systems with fajpaasno of 1 are first checked 
simultaneosly, then all file systems with Jsjpassno of 2, and so on. It is usual to make the 
f8_pa88no of the root file system have the value 1 and then check one file system on each available 
disk drive in each subsequent pass to the exhaustion of file system partitions. 

/etc/ fstab is only read by programs, and not written; it is the duty of the system administrator to 
properly create and maintain this file. The order of records in /etc/ fstab is important because 
fsck, mountf and umount process the file sequentially; file systems must appear after file systems 
they are mounted within. 
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FILES 

/etc/fstab 

SEE ALSO 

getfsent(3), quotacheck(8), quotaon(8) 
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NAME 

gettytab - terminal configuration data base 

SYNOPSIS 

/etc/gettytab 

DESCRIPTION 

Gettytab is a simplified version of the termcap(5) data base used to describe terminal lines. The 
initial terminal login process getty{S) accesses the gettytab file each time it starts, allowing simpler 
reconfiguration of terminal characteristics. Each entry in the data base b used to describe one 
class of terminate. 

There is a default terminal class, default, that is used to set global defaults for all other classes. 
(That is, the default entry is read, then the entry for the class required is used to override particu> 
lar settings.) 

CAPABILITIES 

Refer to termcap{b) for a description of the file layout. The default column below lists defaults 
obtained if there is no entry in the table obtained, nor one in the special default table. 

Name Type Default Description 

ap bool false terminal uses any parity 

bd num backspace delay 

bk str 0377 alternate end of line character (input break) 

cb bool false use crt backspace mode 

cd num carriage-return delay 

ce bool false use crt erase algorithm 

ck bool false use crt kill algorithm 

cl str NULL screen clear sequence 

CO bool false console - add \n after login prompt 

ds str 'Y delayed suspend character 

ec bool false leave echo OFF 

ep bool false terminal uses even parity 

er str '? erase character 

et str 'D end of text (eof) character 

ev str NULL initial enviroment 

fO num unused tty mode flags to write messages 

fl num unused tty mode flags to read login name 

f2 num unused tty mode flags to leave terminal as 

fd num form-feed (vertical motion) delay 

fl str "O output flush character 

he bool false do NOT hangup line on last close 

he str NULL hostname editing string 

hn str hostname hostname 

ht bool fabe terminal has real tabs 

ig bool fabe ignore garbage characters in login name 

im str NULL initial (banner) message 

in str *C interrupt character 

is num unused input speed 

kl str 'U kill character 

Ic bool fabe terminal has lower case 

Im str login: login prompt 

In str *V "literal next" character 

lo str /bin/login program to exec when name obtained 

nd num newline (line-feed) delay 

nl bool false terminal has (or might have) a newline character 
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nx 


str 


defaul 


op 


bool 


false 


OS 


num 


unus 


pc 


str 


\o 


pe 


bool 


false 


Pf 


num 





ps 


bool 


false 


qu 


str 


'\ 


rp 


str 


R 


rw 


bool 


false 


sp 


num 


unus 


su 


str 


Z 


tc 


str 


none 


tp 


num 





tt 


str 


NULL 


ub 


bool 


false 


uc 


bool 


false 


we 


str 


W 


xc 


bool 


false 


xf 


str 


'S 


xn 


str 


Q 
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default next table (for auto speed selection) 
terminal uses odd parity 
unused output speed 
pad character 
use printer (hard copy) erase algorithm 
delay between first prompt and following flush (seconds) 
line connected to a MICOM port selector 
quit character 
line retype character 
do NOT use raw for input, use cbreak 
unused line speed (input and output) 
suspend character 
table continuation 
timeout (seconds) 
terminal type (for enviroment) 
do unbuffered output (of prompts etc) 
terminal is known upper case only 
word erase character 
do NOT echo control chars as *X 
XOFF (stop output) character 
XON (start output) character 

If no line speed is specified, speed will not be altered from that which prevails when getty is 
entered. Specifying an input or output speed overrides line speed for stated direction only. 

Terminal modes to be used for the output of the message, for input of the login name, and to 
leave the terminal set as upon completion, are derived from the Boolean flags specified. If the 
derivation should prove inadequate, any (or all) of these three may be overriden with one of the 
fO, fl, or f2 numeric specifications, which can be used to specify (usually in octal, with a leading 
'0') the exact values of the flags. Local (new tty) flags are set in the top 16 bits of this (32 bit) 
value. 

Should getty receive a null character (presumed to indicate a line break) it will restart using the 
table indicated by the nx entry. If there is none, it will re-use its original table. 

Delays are specified in milliseconds, the nearest possible delay available in the tty driver will be 
used. Should greater certainty be desired, delays with values 0, 1, 2, and 3 are interpreted as 
choosing that particular delay algorithm from the driver. 

The cl screen clear string may be preceded by a (decimal) number of milliseconds of delay 
required (a la termcap). This delay is simulated by repeated use of the pad character pc. 

The initial message, and login message, im and Im may include the character sequence %h to 
obtain the hostname. {%% obtains a single '%' character.) The hostname is normally obtained 
from the system, but may be set by the hn table entry. In either case it may be edited with he. 
The he string is a sequence of characters, each character that is neither '®' nor '#' is copied into 
the final hostname. A '®' in the he string, causes one character from the real hostname to be 
copied to the final hostname. A '#' in the he string, causes the next character of the real host- 
name to be skipped. Surplus '©' and '#' characters are ignored. 

When getty execs the login process, given in the lo string (usually "/bin/login"), it will have set 
the enviroment to include the terminal type, as indicated by the tt string (if it exists). The ev 
string, can be used to enter additional data into the environment. It is a list of comma separated 
strings, each of which will presumably be of the form name=:value. 

If a non-zero timeout is specified, with to, then getty will exit within the indicated number of 
secondSs either having received a login name and passed control to login, or having received an 
alarm signal, and exited. This may be useful to hangup dial in lines. 
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Output from getty is even parity unless op is specified. Op may be specified with ap to allow 
any parity on input, but generate odd parity output. Note: this only applies while getty is being 
run, terminal driver limitations prevent a more complete implementation. Getty does not check 
parity of input characters in RAW mode. 

SEE ALSO 

termcap(5), getty(8). 
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NAME 

group - group file 

DESCRIPTION 

Group contains for each group the following information: 

group name 

encrypted password 

numerical group ED 

a comma separated list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; Each group is separated from the next 
by a new-line. If the password field is null, no password is demanded. 

This file resides in directory /etc. Because of the encrypted passwords, it can and does have gen- 
eral read permission and can be used, for example, to map numerical group ID's to names. 

FILES 

/etc/group 

SEE ALSO 

setgroups(2), initgroups(3), crypt(3), pa8swd(l), passwd(5) 

BUGS 

The pa88wd{l) command won't change the passwords. 
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NAME 

hosts - host name data base 

DESCRIPTION 

The hosts file contains information regarding the known hosts on the DARPA Internet. For each 
host a single line should be present with the following information: 

official host name 
Internet address 
aliases 

Items are separated by any number of blanks and/or tab characters. A "#" indicates the begin- 
ning of a comment; characters up to the end of the line are not interpreted by routines which 
search the file. This file is normally created from the official host data base maintained at the 
Network Information Control Center (NIC), though local changes may be required to bring it up 
to date regarding unofficial aliases and/or unknown hosts. 

Network addresses are specified in the conventional "." notation using the inet_addr{) routine 
from the Internet address manipulation library, m6^(3N)<. Host names may contain any printable 
character other than a field delimiter, newline, or comment character. 

FILES 

/etc/hostiii 

SEE ALSO 

gethostent(3N) 

BUGS 

A name server should be used instead of a static file. A binary indexed file format should be 
available for fast access. 
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NAME 

kbd - keyboard translation table format and default table 

SYNOPSIS 

^include <sundev/kbd.h> 

DESCRIPTION 

Keyboard translation is done in the UNDC kernel via a set of tables. A translation table is 128 
bytes of 'entries', which are bytes (unsigned chars). The top 4 bits of each entry are decoded by a 
case statement in the keyboard translator. If the entry is less than 0x80, it is sent out as an ASCII 
character (possibly with the META bit OR-cd in). 'Special' entries are 0x80 or greater, and 
invoke more complicated actions. 

struct keymap { 

unsigned char keymap|128]; /* maps key codes to actions */ 

}; 

A keyboard is defined by its keymaps. 
struct keyboard { 



struct keymap 
struct keymap 
struct keymap 
struct keymap 
struct keymap 
int 
int 

unsigned char 
unsigned char 



*k_normal; 

*k_shifted; 

*k_caps; 

*k_control; 

*k_up; 

kjdleshifts; 

kjdlebuckys; 

k_abortl; 

k_abort2; 



* Unshifted */ 

* Shifted ♦/ 

* Caps locked */ 

* Controlled */ 

* Key went up "'/ 

* Shifts */ 

* Bucky bits ♦/ 

* 1st key of abort sequence */ 

* 2nd key of abort sequence */ 



}; 

The following defines the bit positions used within kjdleshifts to indicate the 'pressed' (1) or 
'released' (0) state of shift keys. The bit numbers and the aggregate masks are defined. 

Since it is possible to have more than one bit in the shift mask on at once, there is an implied 
priority given to each shift state when determining which translation table to use. The order is 
(from highest priority to lowest) UPMASK, CTRLMASK, SHIFTMASK, and lastly CAPSMASK. 

* Caps Lock key */ 

* Shift Lock key ♦/ 

* Left-hand shift key */ 

* Right-hand shift key */ 

* Left-hand (or only) control key */ 

* Right-hand control key */ 

* Caplock translation table */ 

* Shifted translation table */ 

* Ctrl shift translation table *f 

* Key up translation table */ 



#define CAPSLOCK 


/ 


#defineSHIFTLOCK 


1 / 


#defineLEFTSHIFT 


2 / 


#defineRIGHTSHIFT 


3 / 


#defineLEFTCTRL 


4 / 


#defineRIGHTCTRL 


5 / 


#define CAPSMASK 


0x0001 / 


#define SHIFTMASK 


OxOOOE / 


#define CTRLMASK 


0x0030 / 


#defineL^MASK 


0x0080 / 



Special Entry Keys 

The 'special' entries' top 4 bits are defined below. Generally they are used with a 4-bit parameter 
(such as a bit number) in the low 4 bits. The bytes whose top 4 bits are 0x0 thru 0x7 happen to 
be ASCn characters. They are not special cased, but just normal cased. 

#define SHIFTKEYS 0x80 

thru 0x8F. This key helps to determine the translation table used. The bit position of 
its bit in 'shiftmask' is added to the entry, for example, SHirTKEYS+ LEFTCTRL. When 
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this entiy is invoked, the bit in 'shiftmask' is toggled. Depending which tables you put it 
in, this works well for hold-down keys or press-on, press-off keys. 

#defineBUCKYBITS 0x90 

thru OxOF. This key determines the state of one of the 'bucky' bits above the returned 
ASCn character. This is basically a way to pass mode-key-up/down information back to 
the caller with each 'real' key depressed. The concept, and name 'bucky' (derivation 
unknown) comes from the MIT/SAIL 'TV system — they had TOP, META, CTRL, and a 
few other bucky bits. The bit position of its bit in 'buckybits', minus 7, is added to the 
entiy; for example, bit 0x00000400 is BUCKYBITS4 3. The '-7' prevents us from messing 
up the ASCn char, and gives us 16 useful bucky bits. When this entry is invoked, the 
designated bit in 'buckybits' is toggled. Depending which tables you put it in, this works 
well for hold-down keys or press-on, press-off keys. 

define METABli" 6 

Meta key depressed with key. This is the only user accessible bucky bit. This value is 
added to BUCKYBITS in the translation table. 

#defineSYSTEMBIT 1 

'System' key was down w/key. This is a kernel-accessible bucky bit. Thb value is added 
to BUCKYBITS in the translation table. The system key is currently not used except as a 
place holder to indicate the key used as the k^abortl key (as defined above). 

#define FUNNY OxAO /"* thru OxAF. This key docs one of 16 funny 

things based on the low 4 bits: */ 
#defineNOP OxAO /"* This key does nothing. */ 

#define OOPS QxAl /* This key exists but is undefined. */ 

#defineHOLE 0xA2 /* This key does not exist on the keyboard. 

Its position code should never be 

generated. This indicates a software/ 

hardware misma^tch, or bugs. */ 
#definc NOSCROLL 0xA3 /* This key alternately sends *S or *Q */ 
#define CTRLS 0xA4 /♦ This sends *S and lets NOSCROLL know */ 

#define CTRLQ OxA5 /♦ This sends *Q and lets NOSCROLL know */ 

#define RESET OxAO /* Kbd was just reset */ 

#define ERROR 0xA7 /* Kbd just detected an internal error */ 

#defineIDLE OxAS /* Kbd is idle (no keys down) */ 

C0inbili&Uons OxAO to OxAF are reserved for non-parameterized functions. 

#define STRING OxBO 

thru OxBF. The low-order 4 bits index a table select a string to be returned, char by 
char. Each entry in the table is null terminated. 

#define KTAB_STRLEN 10 /* Maximum string length (including null) */ 

Definitions for the individual string numbers: 

#defineHOMEARROW 0x00 

#define UP ARROW 0x01 

#defineDOWNARROW 0x02 

#defineLEFTARROW 0x03 

#defineRIGHTARROW 0x04 
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String numbers 5 thru F are available to users making custom entries. 

Function Key Groupings 

In the following function key groupings, the low-order 4 bits indicate the function key number 
within the group: 

#defineLEFTFUNC OxCO /* thru OxCF. The 'left' group. */ 

#defineRIGHTFUNC OxDO /* thru OxDF. The 'right' group. */ 

#defineTOPFUNC OxEO /♦ thru OxEF. The 'top' group. */ 

#deflneBOTTOMFUNC OxFO /* thru OxFF. The 'bottom' group. */ 

#define LF(n) (LEFTFUNC+ (n)-l) 

#define RF(n) (RIGHTFUNC+ (n)-!) 

#define TF(n) (TOPFUNC+ (n)-l) 

#define BF(n) (BOTTOMFUNC+ (n)-l) 

The actual keyboard positions may not be on the left/right/top/bottom of the physical keyboard 
(although they usually are). What is important is that we have reserved 64 keys for function 
keys. 

Normally, when a function key is pressed, the following escape sequence is sent through the char- 
acter stream: 

ESC|0..9z 
where ESC is a single escape character and 0..9 indicate some number of digits needed to encode 
the function key as a decimal number. 

DEFAULT TABLES 

The kernel has 3 sets of initial translation tables, one set for each type of keyboard supported. 

#ifndef lint 

static char sccsidf] ^s "Ql^jkeytables.c 1.3 83/10/25 Copyr 1983 Sun Nficro"; 

#endif 

/* 

* Copyright (C) 1983 by Sun Microsystems, Inc. 

V 

/* 

* keytables.c 

« 

* This module contains the translation tables for the up-down encoded 

* Sun keyboards. 

V 

#include ".^/sun/kbd.h" 

/* handy way to define control characters in the tables */ 
#define c(char) (char&OxlF) 
#define ESC Ox IB 

/* Unshifted keyboard table for Micro Switch 103SD32-2 */ 

static struct keymap keytab_m8_lc = ( 

/* */HOLE, BUCKYBITS+ SYSTEMBIT, 

LF(2), LF{3), HOLE, TF(1), TF(2), TF(3), 
/* 8*/TF(4), TF(5), TF(6), TF(7), TF(8), TF(9), TF(IO), TF(ll), 
/* 16 */ TF(12), TF(13), TF(14),c('['), HOLE, RF(1), '+ ', '-', 
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/♦24*/ HOLE, LF(4), '\r, LF(6), HOLE, SHIFTKEYS+ CAPSLOCK, 

'1', '2', 

/*32*/ '3', '4', '5', '6', 7', '8', '9', '0', 

/* 40 ♦/ '-', '-', '", '\b', HOLE, 7', '8', '9', 

/* 48 */ HOLE, LF(7), STRING+ UP ARROW, 

LF(9), HOLE, '\t', 'q', 'w', 
/*56*/ V, 'r', 't', 'y', 'u', 'i', V, 'p', 

/*64*/ '{', '}♦, 'J, HOLE, '4', '5', '6', HOLE, 

/* 72 */ STRING+ LEFTARROW, 

STRING+ HOMEARROW, 

STRING+ RIGHTARROW, 

HOLE, SHIFTKEYS+ SHIFTLOCK, 
'a', '8', 'd', 
/*80*/ T, V, 'h'. 'j', 'k', '1', ';', ':', 

/*88*/ 'I', V» HOLE, '1', '2', '3', HOLE, NOSCROLL, 

/♦ 96 */ STRING+ DOWNARROW, 

LF(97), HOLE, HOLE, SHIFTKEYS+ LEFTSHIFT, 



'z', 'x', 'c'. 



/*104*/ 'v', 'b', 'n', 'm', ',', '.', '/', SHIFTKEYS+ RIGHTSHIFT, 

/*112 ♦/ NOP, 0x7F, '0', NOP, '.', HOLE, HOLE, HOLE, 

/*120 ♦/ HOLE, HOLE, SHIFTKEYS+ LEFTCTRL, 

SHIFTKEYS+ RIGHTCTRL, 
HOLE, HOLE, IDLE, 

h 

/* Shifted keyboard table for Micro Switch 103SD32-2 */ 

static struct keymap keytab_m8_uc = { 

/* 0*/HOLE, BUCKYBITS+SYSTEMBIT, 

LF(2), LF(3), HOLE, TF(l), TF(2), TF(3), 

/* 8*/TF(4), TF(5), TF(6), TF(7), TF(8), TF(9), TF(IO), TF(ll), 

/* 16 */ TF(12), TF(13), TF(14),c('('), HOLE, RF(1), '+ ', '-', 

/* 24 */ HOLE, LF(4), '\f', LF(6), HOLE, SHIFTKEYS+ CAPSLOCK, 

/* 32 ♦/ '#', '$', '%', '&', '\", 

/*40*/ '=»', '*', 'Q', '\b', HOLE, 7', 

/* 48 ♦/ HOLE, LF(7), STRING+ UP ARROW, 

LF(9), HOLE, '\t', 
/*56*/ 'E', 'R', 'T', 'Y', 'U', 

/♦ 64 ♦/ 'I', y, 'J, HOLE, '4', 

/* 72 ♦/ STRING+ LEFTARROW, 

STRING+ HOMEARROW, 

STRING+ RIGHTARROW, 

HOLE, SHIFTKEYS+ SHIFTLOCK, 
'A', 'S', 'D', 
/*80*/ 'F', 'G', 'H', 'J', 'K', 'L', '+', '*', 

/♦ 88 */ 'W, '\r', HOLE, '1', '2', '3', HOLE, NOSCROLL, 

/* 96 */ STRING+ DOWNARROW, 

LF(97), HOLE, HOLE, SHIFTKEYS+ LEFTSHIFT, 

'Z', 'X', 'C, 
/*104*/ 'V, 'B', 'N', 'M', '<•, '>', '?', SHIFTKEYS+ RIGHTSHIFT, 

/*112 */ NOP, Ox7F, '0', NOP, '.', HOLE, HOLE, HOLE, 

/♦120 */ HOLE, HOLE, SHIFTKEYS+ LEFTCTRL, 
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'!', 


>» > 


7', 


'8'. 


'0'! 

'9', 


'5', 


'Q', 
'0', 
'6', 


'W', 

'P', 

HOLE, 



'1', 


•2', 


'9', 


'0', 


•8', 


'9', 


'Q', 


'W, 


'0', 


'P'. 


'6', 


HOLE, 
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SHIFTKEYS+ RIGHTCTRL, 
HOLE, HOLE, IDLE, 

}; 

/* Caps Locked keyboard table for Micro Switch 103SD32-2 */ 

static struct keymap keytab_m8_cl = { 

/* */HOLE, BUCKYBITS+ SYSTEMBIT, 

LF(2), LF(3), HOLE, TF(1), TF(2), TF(3), 

/* 8*/TF(4), TF(5), TF(6), TF(7), TF(8), TF(9), TF(IO), TF(ll), 

/♦ 16 */ TF(12), TF(13), TF(14),c(T), HOLE, RF(1), '+ ', '-', 

/♦ 24 ♦/ HOLE, LF(4), '\r, LF(6), HOLE, SHIFTKEYS+ CAPSLOCK, 

/*32*/ '3', '4', '5', '6', 7', '8', 

/♦40*/ '-', '"', '", '\*>', HOLE, 7', 

/*48*/ HOLE, LF(7), STRING+ UP ARROW, 

LF(9), HOLE, '\t', 
/*56*/ 'E', 'R', 'T', 'Y', 'U', T, 

/♦ 64 ♦/ '{', '}', 'J, HOLE, '4', '5', 

/♦ 72 */ STRING+ LEFTARROW, 

STRING+ HOMEARROW. 

STRING+ R IGHTARROW, 

HOLE, SHIFTKEYS+ SHIFTLOCK, 
'A', 'S', 'D', 
/*80*/ 'F', 'G', 'H', 'J', 'K', 'L', ';', ';', 

/* 88 */ T» '\r', HOLE, '1', '2', '3', HOLE, NOSCROLL, 

/* 96 */ STRING+ DOWNARROW, 

LF(97), HOLE, HOLE, SHIFTKEYS+ LEFTSHIFT, 

'Z', 'X', 'C, 
/*104*/ 'V, 'B', 'N', 'M', ',', '.', 7', SHIFTKEYS+RIGHTSHIFT, 

/*112 */ NOP. 0x7F, '0', NOP, '.', HOLE, HOLE, HOLE, 

/*120 ♦/ HOLE, HOLE, SHIFTKEYS+ LEFTCTRL, 

SmFTKEYS+ RIGHTCTRL, 
HOLE, HOLE, IDLE, 

}; 

/* Controlled keyboard table for Micro Switch 103SD32-2 */ 

static struct keymap keytab_ms_ct — { 

/* 0*/HOLE, BUCKYBITS+ SYSTEMBIT, 

LF(2), LF(3), HOLE, TF(1), TF(2), TF(3), 
/* 8*/TF(4), TF(5), TF(6), TF(7), TF(8), TF(9), TF(IO), TF(ll), 
/* 16 */ TF(12), TF(13), TF(14),c('['), HOLE, RF(1), OOPS, OOPS, 

/* 24 */ HOLE, LF(4), '\r, LF(6), HOLE, SHIFTKEYS+ CAPSLOCK, 

OOPS, OOPS, 
/* 32 */ OOPS, OOPS, OOPS, OOPS. OOPS, OOPS, OOPS, OOPS, 

/*40*/ OOPS. c('"), c('®'), '\b*, HOLE, OOPS, OOPS, OOPS, 

/♦48*/ HOLE, LF(7), STRING+ UP ARROW, 

LF(9), HOLE, '\t', CTRLQ, c('W'), 

/*56*/ c{'E'), c('R'), c('T'), c('Y'), cCU'). c(T), c('O'), c('P'), 

/♦ 64 */ c(['), c(')'), c('_'), HOLE, OOPS, OOPS, OOPS, HOLE, 

/* 72 */ STRING+ LEFTARROW, 
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STRING+ HOMEARROW, 

STRING+ RIGHTARROW, 

HOLE, SHIFTKEYS+ SHIFTLOCK, 

c('A'), CTRLS, c('D'), 

/♦ 80 */ c('F'), c('G'), c('H'), c('J'), c('K'), c('L'), OOPS, OOPS, 

/*88*/ c('\V), 

'\r', HOLE, OOPS, OOPS, OOPS, HOLE, NOSCROLL, 
/* 98 */ STRING+ DOWNARROW, 

LF(97), HOLE, HOLE, SHIFTKEYS+ LEFTSHIFT, 

c('Z'), c('X'), c('C'), 
/*104 */ c('V'), c('B'), c('N'), c('M'), OOPS, OOPS, OOPS, SHIFTKEYS+ RIGHTSHIFT, 

/*112 */ NOP, 0x7F, OOPS, NOP, OOPS, HOLE, HOLE, HOLE, 

/*120 */ HOLE, HOLE, SHIFTKEYS+ LEFTCTRL, 

'\0', SHIFTKEYS+ RIGHTCTRL, 
HOLE, HOLE, IDLE, 



/* "Key Up" keyboard table for Micro Switch 103SD32-2 */ 

static struct key map keytab_ms_up = { 

/* */HOLE, BUCKYBITS-f SYSTEMBIT, 

NOP, NOP, HOLE, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, HOLE, NOP, NOP, NOP, 
NOP, NOP, HOLE, SHIFTKEYS+ CAPSLOCK, 

NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, HOLE, NOP, NOP, NOP, 
NOP, NOP, HOLE, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, HOLE, NOP, NOP, NOP, HOLE, 
NOP, HOLE, SHIFTKEYS+ SHIFTLOCK, 

NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, 
HOLE, NOP, NOP, NOP, HOLE, NOP, 
HOLE, HOLE, SHIFTKEYS+ LEFTSHIFT, 

NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, SHIFTKEYS+ RIGHTSHIFT, 
NOP, NOP, NOP, HOLE, HOLE, HOLE, 
SFIIFTKEYS+ LEFTCTRL, 

NOP, SHIFTKEYS+ RIGHTCTRL, 

HOLE, HOLE, RESET, 



/*16*/ 


NOP, 


NOP, 


/* 24 */ 


HOLE, 


NOP, 


/* 32 */ 


NOP, 


NOP, 


/* 40 */ 


NOP, 


NOP, 


/*48*/ 


HOLE, 


NOP, 


/* 58 */ 


NOP, 


NOP, 


/*64*/ 


NOP, 


NOP, 


/* 72 •/ 


NOP, 


NOP, 


/• 80 ♦/ 


NOP, 


NOP, 


/♦ 88 ♦/ 


NOP, 


NOP, 


/* 98 */ 


NOP, 


NOP, 


/♦104 */ 


NOP, 


NOP, 


/♦112*/ 


NOP, 


NOP, 


/♦120 ♦/ 


HOLE, 


HOLE 



/* Index to keymaps for Micro Switch 103SD32-2 */ 
static struct keyboard keyindex.ms = { 

&keytab_m8jc, 

&keytab_m8_uc, 

&keytab_m8_cl, 

&keytab_m8jct, 

&keytabjtn8„«p, 
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CTLSMASK, /* Shift bits which stay on with idle keyboard */ 
0x0000, /* Bucky bits which stay on with idle keyboard */ 

1, 77, /* abort keys */ 

}; 

/* Unshifted keyboard table for Sun-2 keyboard */ 

static struct keymap keytab_s2Jc = { 

/* 0*/HOLE, BUCKYBITS+SYSTEMBIT, 

LF(2), LF(3), HOLE, TF(1), TF(2), TF(3), 
/♦ 8*/TF(4), TF(5), TF(6), TF(7), TF(8), TF(9), TF(IO). TF(ll), 
/♦ 16 ♦/ TF(12), TF(13), TF(14), TF(15), HOLE, RF(1), RF(2), RF(3), 

/* 24 •/ HOLE, LF(4), LF(5), LF(6), HOLE, c('['), '1'. '2', 

/*32*/ '3', '4', '5', '6', 7', '8', '9', '0', 

/* 40 */ '-', '=', '", '\h\ HOLE, RF(4), RF(5), RF(6), 

/* 48 ♦/ HOLE, LF(7), LF(8), LF(9), HOLE, '\t', 'q', 'w', 

/*56*/ 'e', 'r', V, 'y', 'u', V, V, y, 

/♦64*/ 'I', '!'» 0x7F, HOLE, RF(7), STRING+ UP ARROW, 

RF(9), HOLE, 
/f 72 ♦/ LF(IO), LF(ll), LF(12), HOLE, SHIFTKEYS+ LEFTCTRL, 

'a', '8', 'd', 
/* 80 */ T, 'g', 'h', 'j', 'k', '1', ';', '\", 

/* 88 */ '\V» 'V> HOLE, STRING+ LEFTARROW, 

RF(ll), STRING+ RIGHTARROW, 
HOLE, LF(13), 
/♦ 96 */ LF(14), LF(15), HOLE, SHIFTKEYS+ LEFTSHIFT, 

'z', 'x', 'c', 'v', 
/♦104*/ 'b', 'n', 'm', ',', '.', '/', SfflFTKEYS+ RIGHTSHIFT, 

'\n', 
/♦112 ♦/ RF(13), STRING+ DOWNARROW, 

RF(15),H0LE, HOLE, HOLE, HOLE, HOLE, 
/* 120 ♦/ BUCKYBITS+ METABIT, 

BUCKYBITS+ METABIT, 

HOLE, HOLE, HOLE, ERROR, mLE, 

}; 

/* Shifted keyboard table for Sun-2 keyboard */ 

static struct keymap keytabj52juc = { 

/* ♦/HOLE, BUCKYBITS+'SYSTEMBIT, 

LF(2), LF(3), HOLE, TF(1), TF(2), TF(3), 
/* 8*/TF(4), TF(5), TF(6), TF(7), TF(8), TF(9), TF(IO), TF(ll), 
/♦ 16 */ TF(12), TF(13), TF(14), TF(15), HOLE, RF(1), RF(2), RF(3), 

/* 24 */ HOLE, LF(4), LF(5), LF(6), HOLE, c('('), '!', -q', 

/♦32*/ '#', '$', '%', '-. '&', '*', t, 'V, 

/*40*/ 'J, '+', '~', >', HOLE, RF(4), RF(5), RF(6), 

/* 48 */ HOLE, LF(7), LF(8), LF(9), HOLE, '\t', 'Q', 'W, 

/* 56 ♦/ 'E', 'R', 'T', 'Y', 'U', T, 'O', T', 

/*64*/ '{', '}', 0x7F, HOLE, RF(7), STRING+ UP ARROW, 

RF(9), HOLE, 
/* 72 */ LF(IO), LF(ll), LF(12), HOLE, SHIFTKEYS+ LEFTCTRL, 

'A', 'S', 'D', 
/*80*/ 'F', 'G', 'H', 'J', 'K', 'L', 



».f i»i 
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/•88*/ T. '\r', HOLE, STRING+LEFTARROW, 

RF(ll), STRING+ RIGHT ARROW, 
HOLE, LF(13), 

/♦ 96 */ LF(14), LF(15), HOLE, SHIFTKEYS+ LEFTSHIFT, 

'Z', 'X', 'C, 'V, 

/♦104*/ 'B', 'N', 'M', '<', '>', '?', SHIFTKEYS+ RIGHTSHIFT, 

'\n', 
/*112 */ RF(13), STRING+ DOWNARROW, 

RF(15), HOLE, HOLE, HOLE, HOLE, HOLE, 
/♦120 */ BUCKYBITS+ METABIT, 

BUCKYBITS+ METABIT, 

HOLE, HOLE, HOLE, ERROR, IDLE, 

}; 



/* Controlled keyboard table for Sun-2 keyboard */ 

static struct keymap keytabj52_ct = { 

/♦ 0*/HOLE, BUCKYBITS+SYSTEMBIT, 

LF(2), LF(3), HOLE, TF(l), TF(2), TF(3), 
/♦ 8*/TF(4), TF(5), TF{6), TF(7), TF(8), TF(9), TF{10), TF(ll), 
/* 16 */ TF(12), TF(13), TF(14), TF(15), HOLE, RF(1), RF(2), RF(3), 

/* 24 ♦/ HOLE, LF(4), LF(5), LF(6), HOLE, c('('), '1', c('®'), 

/*32*/ '3', '4', '5', c('*'), 7', '8', '9', '0', 

/*40*/ c('J), '«', cC"), '\b', HOLE, RF(4), RF(5). RF(6), 

/* 48 */ HOLE, LF(7), LF(8), LF(9), HOLE, '\t', c('q'), c('w'), 

/*58*/ c(V), c(V), c('t'), c('y'), c('u'), c(T), c('o'), c(y), 

/*64*/ c('['), c('l'), Ox7F, HOLE, RF(7), STRING+ UP ARROW, 

RF(9), HOLE, 
/* 72 */ LF(IO), LF(ll), LF(12), HOLE, SHIFTKEYS+ LEFTCTRL, 

c('a') c('s') c('d') 
/*80*/ c(T). c('g'), c('h'), c(T), c('k'), c(T),' ';', ' '\". ' 

/* 88 */ cCW), 

'\r', HOLE, STRING+LEFTARROW, 

RF{11), STRING+ RIGHTARROW, 
HOLE, LF(13), 
/* 96 */ LF(14), LF(15), HOLE, SHIFTKEYS+ LEFTSHIFT, 

c('z'), c('x'), c('c'), c('v'), 
/*104*/ c('b'), c('n'), c{'m'), ',', '.', c('J), SHIFTKEYS+ RIGHTSHIFT, 

'\n', 
/*112 */ RF(13), STRING+ DOWNARROW, 

RF(15),H0LE, HOLE, HOLE, HOLE, HOLE, 
/♦120 ♦/ BUCKYBITS+ METABIT, 

cC '), BUCKYBITS+ METABIT, 

HOLE, HOLE, HOLE, ERROR, IDLE, 



/* "Key Up" keyboard table for Suii-2 keyboard */ 

static struct keymap keytab_s2_up == { 

/* */HOLE, BUCK^-BITS+SYSTEMBIT, 
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/* 8*/00PS, 

/*16*/ 

/* 24 */ 

/* 32 */ 

/♦ 40 */ 

/♦48*/ 

/* 56 ♦/ 

/* 64 ♦/ 

/♦ 72 ♦/ 

/* 80 ♦/ 
/♦ 88 */ 
/*96*/ 



OOPS, 

OOPS, 

HOLE, 

NOP, 

NOP, 

HOLE, 

NOP, 

NOP, 

OOPS, 



OOPS, 

OOPS, 

OOPS, 

NOP, 

NOP, 

OOPS, 

NOP, 

NOP, 

OOPS, 



NOP, NOP, 
NOP, NOP, 
OOPS, OOPS, 



/♦104 ♦/ NOP, NOP, 



/♦112 */ 
/♦120 ♦/ 



OOPS, OOPS, 
BUCKYBITS+ 
NOP, 



}; 



OOPS, OOPS, HOLE, OOPS, OOPS, OOPS, 
OOPS, OOPS, OOPS, OOPS, OOPS, 
OOPS, OOPS, HOLE, OOPS, OOPS, NOP, 
OOPS, OOPS, HOLE, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, HOLE, OOPS, OOPS, NOP, 
OOPS, OOPS, HOLE, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, HOLE, OOPS, OOPS, NOP, HOLE, 
OOPS, HOLE, SHIFTKEYS+LEFTCTRL, 

NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, 
HOLE, OOPS, OOPS, NOP, HOLE, OOPS, 
HOLE, SHIFTKEYS+LEFTSHIFT, 

NOP, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, SHIFTKEYS+ RIGHTSHIFT, 

NOP, 
NOP, HOLE, HOLE, HOLE, HOLE, HOLE, 
METABIT, 
BUCKYBITS+ METABIT, 

HOLE, HOLE, HOLE, HOLE, RESET, 



/* Index to keymaps for Sun-2 keyboard */ 
static struct keyboard keyindexjs2 a { 

&keytab_82Jc, 

&keytab 82 uc, 

0, 

&kcytabjs2_ct, 

&keytabjs2_up, 

0x0000, /* Shift bits which stay on with idle keyboard ♦/ 

0x0000, /* Bucky bits which stay on with idle keyboard */ 

1, 77, /* abort keys */ 

}; 

/* Unshifted keyboard table for "VTIOO style" */ 

static struct keymap keytab_vt_lc = { 

/♦ */HOLE, BUCKYBITS+ SYSTEMBIT, 

HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 
/* 8*/H0LE, HOLE, STRING+ UP ARROW, 

STRING+ DOWNARROW, 

STRING+ LEFTARROW, 

STRING+ RIGHTARROW, 
HOLE, TF(1), 
/*16*/ TF(2), TF(3), TF(4), c('['), '!', '2', 

/*24*/ '5', '6', 7', '8', '9', '0', 

/*32*/ '", c('H'), BUCKYBITS+ METABIT, 

'7', '8', '9' 
/MO*/ 'q', 'W. 'e', V,' 'f,' 'y'', 

/*48*/ V, y, '(', 'I', 0x7F, '4', 

/* 56 */ ',', SHIFTKEYS+ LEFTCTRL, 

SHIFTKEYS+ CAPSLOCK, 



'3', 


'4', 


1 » 




J » 
" » 


•\f, 


'u'. 


'i', 


'5', 


'6', 



36 



Last change: 19 March 1984 



Sun Release 1.1 



KBD(5) FILE FORMATS KBD(5) 



'a', '8', 'd', r, 'g', 

/♦64*/ 'h', 'j', 'k', T, ';', '\", '\r', 'W, 

/♦72*/ '1', '2', '3', NOP, NOSCROLL, 

SHIFTKEYS+ LEFTSHIFT, 
'z', 'X', 

/*80*/ V, 'V', 'b', V, 'm', ',', '.', V, 

/♦ 88 */ SHIFTKEYS+ RIGHTSHIFT, 

'\n', '0', HOLE, '.', '\r', HOLE, HOLE, 

/* 96 */ HOLE, HOLE, ' ', HOLE, HOLE, HOLE, HOLE, HOLE, 

/♦104 */ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 

/*112 */ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 

/*120 ♦/ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, IDLE, 



/* Shifted keyboard table for "VTIOO style" */ 

static struct keymap keytab_vt_uc «■ { 

/♦ ♦/HOLE, BUCKYBITS+ SYSTEMBIT, 

HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 
/♦ 8*/H0LE, HOLE, STRING+ UP ARROW, 

STRING+ DOWNARROW, 

STRING+ LEFTARROW, 

STRING+ RIGHTARROW, 
HOLE, TF(1), 
/*16*/ TF(2), TF(3), TF(4), c('|'), '!', 'Q', '#', '$', 

/*24*/ •%', '*', '&', '*', X, ')', 'J, '+', 

/*32*/ '~', c('H'), BUCKYBITS+ METABIT, 

7', '8', '9', '-', '\t', 

/*40*/ 'Q', 'W, 'E', 'R', 'T', 'Y', 'U', T, 

I* AS* I 'O', 'P', '{', '}', Ox7F, '4', '5', '6', 

/* 56 ♦/ ',', SHIFTKEYS+ LEFTCTRL, 

SHIFTKEYS+ CAPSLOCK, 

'A', 'S', 'D', 'F', 'G', 
/*64*/ 'H', 'J', 'K', 'L', ':', "", '\r', '|', 

1*12*1 '1', '2', '3', NOP, NOSCROLL, 

SHIFTKEYS+ LEFTSHIFT, 
'Z', 'X', 
/♦80*/ 'C, 'V, 'B', 'N', 'M', '<•, '>', '?', 

/* 88 */ SHIFTKEYS+ RIGHTSHIFT, 

'\n', 'O'j HOLE, '.', '\r', HOLE, HOLE, 

/* 96 •/ HOLE, HOLE, ' ', HOLE, HOLE, HOLE, HOLE, HOLE, 

/♦104 */ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 

/♦112 ♦/ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 

/*120 */ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, IDLE, 



}; 

/* Caps Locked keyboard table for "VTIOO style" */ 

static struct keymap keytab_vt_cl = { 

/♦ */HOLE, BUCKYBITS+ SYSTEMBIT, 

HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 
/♦ 8 */HOLE, HOLE, STRING+ UP ARROW, 
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STRING+ DOWNARROW, 

STRING+ LEFTARROW, 

STRING+ RIGHTARROW, 
HOLE, TF(1), 



* 16 */ 

♦ 24*/ 
♦32*/ 


TF( 

'5', 
> 


♦40*/ 
♦48^/ 
*b6*/ 


'0', 

> 1 


♦64*/ 


'1'. 



'2', 
'0', 



TF(2), TF(3), TF(4), c('['), '1', 

•6', 7', '8', '9', 

c('H'), BUCKYBITS+ METABIT, 

7', '8', '9', 

•t?' »D» "r» »Y» 



'3', 



'4', 



♦ » 

»TTt 



•5', 



6', 






'F', 






♦80*/ 
♦88*/ 

♦96*/ 
♦104 */ 
♦112 */ 
*120 ♦/ 



'W, 'E', 'R', 'T', 

T', '('» •]', 0x7F, '4', 

SHIFTKEYS+ LEFTCTRL, 

SHIFTKEYS+ CAPSLOCK, 
'A', 'S', 'D', 

'2', '3', NOP, NOSCROLL, 

SHIFTKEYS+ LEFTSHIFT, 
'Z', 'X', 

'V, 'B', 'N', 'M', ',', '.', 7', 
SHIFTKEYS+ RIGHTSHIFT, 

'\n', '0', HOLE, '.', '\''. HOLE, HOLE, 
HOLE, HOLE, ' ', HOLE, HOLE, HOLE, HOLE, HOLE, 
HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 
HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 
HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, IDLE, 



'C, 



* Controlled keyboard table for "VTIOO style" */ 

static struct keymap keytab_vt_ct — { 

* ♦/HOLE, BUCKYBITS+ SYSTEMBIT, 

HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 

* 8*/H0LE, HOLE, STRING+ UP ARROW, 

STRING+ DOWNARROW, 

STRING+ LEFTARROW, 

STRING+ RIGHTARROW, 
HOLE, TF(1), 
TF(2), TF(3), TF(4), c('('), '1', cC®'), '3', '4', 
'5', c('-), 7', '8', '9', '0', c('J), '=', 
c('*'), c('H'), BUCKYBITS+ METABIT, 

7', '8', '9', '-', '\t', 

CTRLQ, c('W'), c('E»), c('R'). c('T'), c(T'), c('U'), c(T), 

cCO'). c(T'), cCp), c('l'), OxTF, '4', '5', '6', 
SHIFTKEYS+ LEFTCTRL, 

SHIFTKEYS+ CAPSLOCK, 

c('A'), CTRLS, c('D'), c('F'), c('G'), 

c('H*), c('J'), c('K'), c('L'). V, "", \f\ c('\V), 

'1', '2', '3', NOP, NOSCROLL, 

SHIFTKEYS+ LEFTSHIFT, 
c('Z'), c('X'), 
c('C'). c('V'), c('B'), c('N'), c('M'). ',', '.', c('J), 

SHIFTKEYS+ RIGHTSHIFT, 

'\n', '0', HOLE, '.', '\r', HOLE, HOLE, 

/♦ 96 ♦/ HOLE, HOLE, c(' '), HOLE, HOLE, HOLE, HOLE, HOLE, 



/* 


16 


♦ / 


/* 


24 


♦ / 


/* 


32 


♦/ 


/* 


40 


*/ 


/• 


48 


*/ 


/♦ 


56 


♦ / 


/* 


64 


*/ 


/* 


72 


♦ / 


/♦ 


80 


*/ 


/* 


88 


♦ / 
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/*104 ♦/ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 

/•112 ♦/ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 

/*120 ♦/ HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, IDLE, 

}; 



/* "Key up" keyboard table for "VTIOO style" */ 

static struct keymap keytab_vt_up = { 

/♦ */HOLE, BUCKYBITS+ SYSTEMBIT, 

HOLE, HOLE, HOLE, HOLE, HOLE, HOLE, 
/* 8 */HOLE, HOLE, NOP, NOP, NOP, NOP, HOLE, NOP, 

NOP, NOP, NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, BUCKYBITS+ METABIT, 

NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, SHIFTKEYS+ LEFTCTRL, 

SHIFTKEYS+ CAPSLOCK, 

NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, SHIFTKEYS+ LEFTSHIFT, 

NOP, NOP, 
NOP, NOP, NOP, NOP, NOP, NOP, NOP, NOP, 



/* 


16 


♦/ 


/* 


24 


V 


/* 


32 


V 


/* 


40 


•/ 


/♦ 


48 


*/ 


/* 


56 


*/ 


/* 


64 


*/ 


/* 


72 


•/ 


/* 


80 


V 


/* 


88 


*/ 


I* 


96 


♦/ 


/* 


104 


*/ 


1* 


112 


*/ 


1* 


120 


*/ 



SHIFTKEYS+ RIGHTSHIFT, 
NOP, NOP, HOLE 
HOLE, HOLE, NOP, HOLE 
HOLE, HOLE, HOLE, HOLE 
HOLE, HOLE, HOLE, HOLE 
HOLE, HOLE, HOLE, HOLE 



NOP, NOP, HOLE 
HOLE, HOLE, HOLE 
HOLE, HOLE, HOLE 
HOLE, HOLE, HOLE 
HOLE, HOLE, HOLE 



HOLE, 
HOLE, 
HOLE, 
HOLE, 
RESET, 



/* Index to keymaps for "VTIOO style" keyboard */ 
static struct keyboard keyindex_vt = { 

&keytab_vt_lc, 

&keytab_vt_uc, 

&keytab_vt_cl, 

&keytab_vt_ct, 

&kcytab_vt_up, 

CAPSMASK+ CTLSMASK, /* Shift keys that stay on at idle keyboard */ 

0x0000, /* Bucky bits that stay on at idle keyboard */ 

1, 59, /* abort keys */ 

}; 

/* Index table for the whole shebang */ 

int nkeytables = 3; /* max 16 */ 
struct keyboard *keytables[] = { 

&keyindex_ms, 

&keyindcx_vt. 
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}; 

/* 
*/ 



&keyindexj52, 



Keyboard String Table 



This defines the strings sent by various keys (as selected in the 
tables above). 



#define kste8cinit(c) {'\033', '(', 'c', '\0'} 
char keystringtab[16llKTAB_STRLENl = { 

kstescinit(H) /*home*/, 

kstescinit(A) /*up*/, 

k8tescinit(B) /*down*/, 

kstescinitJD) /*left*/, 

kstescinitjc) /♦right*/, 

h 

SEE ALSO 

cons(4S) 

BUGS 

This keyboard translation implementation is essentially the PROM monitor mechanism moved 
into the kernel. It will almost certainly be reworked in the future to take advantage of the 
greater, flexibility available to the kernel that was not available in the PROM. 
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NAME 

mtab - mounted file system table 

SYNOPSIS 

#include <f8tab.h> 
#include <mtab.h> 

DESCRIPTION 

Mtab resides in directory /etc and contains a table of devices mounted by the mount command. 
Umount removes entries. 

The table is a series of mtab structures, as defined in <mtab.h>. Each entry contains the null- 
padded name of the place where the special file is mounted, the null-padded name of the special 
file, and a type field, one of those defined in <f8tab.h>. The special file has all its directories 
stripped away; that is, everything through the last '/' is thrown away. The type field indicates if 
the file system is mounted read-only, read-write, or read-write with disk quotas enabled. 

This table is present only so people can look at it. It does not matter to mount if there are dupli- 
cated entries nor to umount if a name cannot be found. 

FILES 

/etc/mtab 

SEE ALSO 

mount(8) 
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NAME 

networks - network name data base 

DESCRIPTION 

The networks file contains information regarding the known networks which comprise the DARPA 
Internet. For each network a single line should be present with the following information: 

official network name 
network number 
aliases 

Items are separated by auy number of blanks and/or tab characters. A "#" indicates the begin- 
ning of a comment; characters up to the end of the line are not interpreted by routines which 
search the file. This file is normally created from the official network data base maintained at the 
Network Information Control Center (NIC), though local changes may be required to bring it up 
to date regarding unofficial aliases and/or unknown networks. 

Network number may be specified in the conventional "." notation using the inet_network{) rou- 
tine from the Internet address manipulation library, me<(3N). Network names may contain any 
printable character other than a field delimiter, newline, or comment character. 

FILES 

/etc/networks 

SEE ALSO 

getnetent(3N) 

BUGS 

A name server should be used instead of a static file. A binary indexed file format should be 
available for fast access. 
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NAME 

news - USENET network news article, utility files 

DESCRIPTION 

There are two formats of news articles: A and B. A format is the only format that version 1 net- 
news systems can read or write. Systems running the version 2 netnews can read either format 
and there are provisions for the version 2 netnews to write in A format. A format looks like this: 

Aarticle-ID 

newegroupf 

path 

date 

title 

Body of artiete 

Only version 2 netnews systems can read and write B format. B format contains two extra pieces 
of information: receival date and expiration date. The basic structure of a B format file consists 
of a series of headers and then the body. A header field is defined as a line with a capital letter in 
the Ist column and a colon somewhere on the line. Unrecognized header fields are ignored. News 
is stored in the same format transmitted, see "Standard for the Interchange of USENET Mes- 
sages" for a full description. The following fields are among those recognized: 

Header Information 

Froms userQhoet.domainf.domain ...J (Full Name) 

Newsgroupst Newagroupe 

Message-IDt < Unique Identifier> 

Subjects descriptive title 

Dates DatePoeted 

Pate-Reeelveds 

Date received on local machine 

Explress Expiration Date 

Reply-Tos Address for mail replies 

Refereneees Article ID of article this is 

Controls Text of a control message 

Here is an example of an article: 

Relay-Version: B 2.10 2/13/83 cbosgd.UUCP 
Posting-Version: B 2.10 2/13/83 eagle.UUCP 
Path: cbosgd!mhuxi!mhuxt!eagle!jerry 
From: jerry Oeagle.uucp (Jerry Schwarz) 
Newsgroups: net.general 
Subject: Usenet Etiquette — Please Read 
Message-ID: <642Qeagle.UUCP> 
Date: Friday, 19-Nov-82 16:14:55 EST 
FoUowup-To: net.news 
Expires: Saturday, l-Jan-83 00:00:00 EST 
Date-Received: Friday, 19-Nov-82 16:59:30 EST 
Organization: Bell Labs, Murray Hill 

The body of the article comes here, after a blank line. 



Sun Relea^i 1.1 Last change: 6 January 1984 43 

■k 



NEWS (5) FILE FORMATS NEWS (5) 



A sya file line has four fields, each seperated by colons: 

8y8tem-name:8ub8cription8:flags:tran8Tni88ion command 

Of these fields, on the 8y8tem'name and 8ub8cription8 need to be present. 

The 8y8tem name is the name of the system being sent to. The 8ub8cription8 is the list of news- 
groups to be transmitted to the system. The flags are a set of letters describing how the article 
should be transmitted. The default is B. Valid flags include A (send in A format), B (send in B 
format), N (use ihave/sendme protocol), U (use uux -c and the name of the stored article in a %b 
string). 

The transmission command is executed by the shell with the article to be transmitted as the stan- 
dard input. The default is uux — s -r sysnamelrneyHB, Some examples: 

xyK:net.all 

old8y8:net.aU|fa.aU,to.oldBy8tA. 

berksy8:net.aU,ucb.all:i/u8r/lib/new8/Bendnew8 -b berk8y8rnew8 
arpa8y8:net.aUfarpa.aIl»/u8r/lib/new8/Bendnew8 -a rnew8®arpa8y8 
oId2:net.aIl,fa.alltA.t/u8r/Ub/8endnew8 -o oldSrnews 
u8isrtfa.8f-loversmnall U8er 

Somewhere in a sys file, there must be a line for the host system. This line has no flags or com- 
mands. A # as the first character in a line denotes a comment. 

The history, active, and ngfile files have one line per item. 

SEE ALSO 

inews(l), postnew8(l), 8endnew8(8), uurec(8), readnews(l) 
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NAME 

newsrc - infoimation file for readnews(l) and checknews(l) 

DESCRIPTION 

The .newerc file contains the list of previously read articles and an optional options line for read- 
new8{l) and checknew8{l). Each ne>vsgroup that articles have been read from has a line of the 
form: 

.IR newsgroup : " range" 
Range is a list of the articles read. It is basically a list of numbers separated by commas with 
sequential numbers collapsed with hyphens. For instance: 

generali 1-78,80,85-00 

fa.info-cpms 1-7 

net.newss 1 

fa.info-vax! 1-5 

If the : is replaced with an ! (as in info-vax above) the newsgroup is not subscribed to and is not 
be shown to the user. 

An options line starts with the word options (left-justified). Then there are the list of options 
Jist as they would be on the command line. For instance: 

options -n all !fa.Bf-lovers !fa.hu man-nets -r 

options -e -r 

A string of lines beginning with a space or tab after the initial options line are considered con- 
tinuation lines. 

FILES 

"/.newsrc options and list of previously read articles 

SEE ALSO 

readnews(l), checknews(l) 
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NAME 

passwd - password file 

DESCRIPTION 

Passwd contains for each user the following information: 

name (login name, contains no upper case) 

encrypted password 

numerical user ID 

numerical group ID 

user's real name, office, extension, home phone. 

initial working directory 

program to use as Shell 

The name may contdn '&', meaning insert the login name. 

The password file is an ASCII file. Each field within each user's entry is separated from the next 
by a colon. Each user is separated from the next by a new-line. If the password field is null, no 
password is demanded; if the Shell field is null, /bin/sh is used. 

The password file resides in directory /etc. Because of the encrypted passwords, it can and does 
have genera! read permission and can be used, for example, to map numerical user ID's to names. 

Appropriate precautions must be taken to lock the file against changes if it is to be edited with a 
text editor; vipw{S) does the necessary locking. 

FILES 

/etc/passwd 

SEE ALSO 

getpwent(3), login(l), crypt(3), passwd(l), group(5), vipw(8), adduser(8) 

BUGS 

A binary indexed file format should be available for fast access. 

User information (name, office, etc.) should be stored elsewhere. 
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NAME 

phones - remote host phone number data base 

DESCRIPTION 

The file /etc/phones contains the system-wide private phone numbers for the tip{lC) program. 
This file is normally unreadable, and so may contain privileged information. The format of the 
file is a series of lines of the form: < system-name >( \tl*<phone-number>. The system name is 
one of those defined in the remote{5) file and the phone number is constructed from [0123456789- 
=*%). The "=" and "*" characters are indicators to the auto call units to pause and wait for a 
second dial tone (when going through an exchange). The "=" is required by the DF02-AC and 
the '•*" is required by the BIZCOMP 1030. 

Only one phone number per line is permitted. However, if more than one line in the file contains 
the same system name tip{lC) will attempt to dial each one in turn, until it establishes a connec- 
tion. 

FILES 

/etc/phones 

SEE ALSO 

tip(lC), remote(5) 
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NAME 

plot - graphics interface 

DESCRIPTION 

Files of this format are produced by routines described in plot{3X), and are interpreted for various 
devices by commands described in plot{lG). A graphics file is a stream of plotting instructions. 
Each instruction consists of an ASCII letter usually followed by bytes of binary information. The 
instructions are executed in order. A point is designated by four bytes representing the x and y 
values; each value is a signed integer. The last designated point in an l, m, n, or p instruction 
becomes the 'current point' for the next instruction. 

Each of the following descriptions begins with the name of the corresponding routine in plot{SX). 

m move: The next four bytes give a new current point. 

n cont: Draw a line from the current point to the point given by the next four bytes. See 
plot{lG). 

p point: Plot the point given by the next four bytes. 

1 line: Draw a line from the point given by the next four bytes to the point given by the follow- 
ing four bytes. 

t label: Place the following ASCII string so that its first character falls on the current point. 
The string is terminated by a newline. 

a arc: The first four bytes give the center, the next four give the starting point, and the last four 
give the end point of a circular arc. The least significant coordinate of the end point is used 
only to determine the quadrant. The arc is drawn counter-clockwise. 

c circle: The first four bytes give the center of the circle, the next two the radius. 

e erase: Start another frame of output. 

f linemod: Take the following string, up to a newline, as the style for drawing further lines. 
The styles are 'dotted,' 'solid,' 'longdashed,' 'shortd ashed,' and 'dotdashed.' Effective only in 
plot 4014 ^nd plot ver. 

8 space: The next four bytes give the lower left corner of the plotting area; the following four 
give the upper right corner. The plot will be magnified or reduced to fit the device as closely 
aa possible. 

Space settings that exactly fill the plotting area with unity scaling appear below for devices 
supported by the filters of plot{lG). The upper limit is just outside the plotting area. In 
every case the plotting area is taken to be square; points outside may be displayable on dev- 
ices whose face isn't square. 

4014 8pace(0, 0, 3120, 3120); 

ver spaccjo, 0, 2048, 2048); 

300, 300s spacejo, 0, 4096, 4096); 

450 spacejo, 0, 4096, 4096); 

SEE ALSO 

plot(lG), plot(3X), graph(ld) 
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NAME 

printcap - printer capability data base 

SYNOPSIS 

/etc/printcap 

DESCRIPTION 

Printcap is a simplified version of the termcap{b) data base for describing printers. The spooling 
system accesses the printcap file every time it is used, allowing dynamic addition and deletion of 
printers. Each entry in the data base describes one printer. This data base may not be substi- 
tuted for, as is possible for termcap, because it may allow accounting to be bypassed. 

The default printer ia normally Ip, though the environment variable PRINTER may be used to 
override this. Each spooling utility supports a -Fprinter option to explicitly name a destination 
printer. 

Refer to the Line Printer Spooler Manual in the Sun System Manager's Manual for a discussion of 
how to set up the database for a given printer. 

Each entry in the printcap file describes a printer, and is a line consisting of a number of fields 
separated by ':' characters. The first entry for each printer gives the names which are known for 
the printer, separated by 'j' characters. The first name is conventionally a number. The second 
name given is the most common abbreviation for the printer, and the last name given should be a 
long name fully identifying the printer. The second name should contain no blanks; the last 
name may well contain blanks for readability. Entries may continue onto multiple lines by giving 
a \ as the last character of a line, and empty fields may be included for readability. 

Capabilities in printcap are all introduced by two-character codes, and are of three types: 



Boolean capabilities indicate that the printer has some particular feature. Boolean capabilities 
are simply written between the ':' characters, and are indicated by the word 'bool' in 
the type column of the capabilities table below. 

Numeric capabilities supply information such as baud-rates, number of lines per page, and so 
on. Numeric capabilities are indicated by the word 'num' in the type column of the 
capabilities table below. Numeric capabilities are given by the two-character capabil- 
ity code followed by the '#' character, followed by the numeric value. For example: 
:br#1200: is a numeric entry stating that this printer should run at 1200 baud. 

String capabilities give a sequence which can be used to perform particular printer operations 
such as cursor motion. String valued capabilities are indicated by the word 'str' in the 
type column of the capabilities table below. String valued capabilities are given by 
the two-character capability code followed by an '=' sign and then a string ending at 
the next following ':'. For example, :rp=spinwriter: is a sample entry stating that 
the remote printer is named 'spinwriter'. 



Description 



Name 


Type 


Defau 


af 


str 


NULL 


br 


num 


none 


cf 


str 


NULL 


df 


str 


NULL 


du 


str 





fc 


num 





ff 


str 


••\r 


fo 


bool 


false 


fs 


num 





gf 


str 


NULL 


ic 


bool 


false 



name of accounting file 

if Ip is a tty, set the baud rate (ioctl call) 

cifplot data filter 

TeX data filter (DVI format) 

User ID of user 'daemon'. 

if Ip is a tty, clear flag bits (sgtty.h) 

string to send for a form feed 

print a form feed when device is opened 

like 'fc' but set bits 

graph data filter (plot (3X) format) 

driver supports (non standard) ioctl 
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call for indenting printout 

name of text filter which does accounting 

error logging file name 

name of lock file 

device name to open for output 

maximum number of copies 

maximum file size (in BUFSIZ blocks), zero =» unlimited 

next directory for list of queues (unimplemented) 

ditroff data filter (device independent troff) 

name of output filtering program 

page length (in lines) 

page width (in characters) 

page width in pixels (horizontal) 

page length in pixels (vertical) 

filter for printing FORTRAN style text files 

machine name for remote printer 

remote printer name argument 

restrict remote users to those with local accounts 

open printer device read/write instead of read-only 

short banner (one line only) 

suppress multiple copies 

spool directory 

suppress form feeds 

suppress printing of burst page header 

status file name 

troff data filter (cat phototypesetter) 

trailer string to print when queue empties 

raster image filter 

if Ip is a tty, clear local mode bits (tty (4)) 

like 'xc' but set bits 

Error messages sent to the console have a carriage return and a line feed appended to them, 
rather than just a line feed. 

If the local line printer driver supports indentation, the daemon must understand how to invoke 
it. 

SEE ALSO 

termcap(5), lpc(8), lpd(8), pac(8), Ipr(l), Ipq(l), Iprm(l) 

The Line Printer Spooler Manual in the Sun System Manager's Manual. 



if 


str 


NULL 


If 


str 


"/dev/console" 


lo 


str 


"lock" 


Ip 


str 


"/dev/lp" 


mc 


num 





mx 


num 


1000 


nd 


str 


NULL 


nf 


str 


NULL 


of 


str 


NULL 


pl 


num 


66 


pw 


num 


132 


px 


num 





py 


num 





rf 


str 


NULL 


rm 


str 


NULL 


rp 


str 


"Ip" 


rs 


bool 


false 


rw 


bool 


false 


sb 


bool 


false 


8C 


bool 


false 


sd 


str 


"/usr/spool/lpd" 


sf 


bool 


false 


sh 


bool 


false 


St 


str 


"status" 


tf 


str 


NULL 


tr 


str 


NULL 


vf 


str 


NULL 


xc 


num 





xs 


num 
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NAME 

protocols - protocol name data base 

SYNOPSIS 

/etc/protocols 

DESCRIPTION 

The protocols flle contains information regarding the known protocols used in the DARPA Inter- 
net. For each protocol a single line should be present with the following information: 

official protocol name 
protocol number 
aliases 

Items are separated by any number of blanks and/or tab characters. A "#" indicates the begin- 
ning of a comment; characters up to the end of the line are not interpreted by routines which 
search the file. 

Protocol names may contain any printable character other than a field delimiter, newline, or com- 
ment character. 

EXAMPLE 

The following example is taken from the Sun UNIX system. 

# 

# Internet (IP) protocols 



ip 





IP 


icmp 


1 


ICMP 


ggP 


2 


GGP 


tcp 


6 


TCP 


pup 


12 


PUP 


udp 


17 


UDP 



# internet protocol, pseudo protocol number 

# internet control message protocol 

# gateway-gateway protocol 

# transmission control protocol 

# PARC universal packet protocol 

# user datagram protocol 



FILES 

/etc/protocols 

SEE ALSO 

getprotoent(3N) 

BUGS 

A name server should be used instead of a static file, 
available for fast access. 



A binary indexed file format should be 
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NAME 

remote - remote h<»t description file 

DESCRIPTION 

The systems known by tip{lC) and their attributes are stored in an ASCII file which is structured 
somewhat like the termcap{5) file. Each line in the file provides a description for a single system. 
Fields are separated by a colon (":")• Lines ending in a \ character with an immediately follow- 
|]pg newline are continued on the next line. 

The first entry is the name(s) of the host system. If there is more than one name for a system, 
the names are separated by vertical bars. After the name of the system comes the fields of the 
description. A field name followed by an '=s' sign indicates a string value follows. A field name 
followed by a '#' sign indicates a following numeric value. 

Entries named "tip""' and "cu""' are used as default entries by tip, and the cu interface to tip, as 
follows. When tip is invoked with only a phone number, it looks for an entry of the form 
"tip300", where 300 is the baud rate with which the connection is to be made. When the cu 
interface is used, entries of the form "cuSOO" are used. 

CAPABILITIES 

Capabilities are either strings (str), numbers (num), or boolean flags (bool). A string capability is 
specified by capability=value; e.g. "dv=/dev/harris". A numeric capability is specified by 
cap ability^ value; e.g. "xa#99". A boolean capability is specified by simply listing the capability. 

at (str) Auto call unit type. 

br (num) The baud rate used in establishing a connection to the remote host. This is a 

decimal number. The default baud rate is 300 baud. 

cm (str) An initial connection message to be sent to the remote host. For example, if a host 
is reached through port selector, this might be set to the appropriate sequence required to 
switch to the host. 

cu (str) Call unit if making a phone call. Default is the same as the 'dv' field. 

dl (str) Disconnect message sent to the host when a disconnect is requested by the user. 

du (bool) This host is on a dial-up line. 

dv (str) UNIX device(s) to open to establish a connection. If thb file refers to a terminal line, 
tip{lC) attempts to perform an exclusive open on the device to insure only one user at a 
time has access to the port. 

el (str) Characters marking an end-of-line. The default is NULL. '"' escapes are only recog- 

nized by tip after one of the characters in 'el', or after a carriage-return. 

fs (str) Frame size for transfers. The default frame size is equal to BUFSIZ. 

hd (bool) The host uses half-duplex communication, local echo should be performed. 

ie (str) Input eod-of-file marks. The default is NULL. 

oc (str) Output end-of-file string. The default is NULL. When tip ia transferring a file, this 

string is sent at end-of-file. 

pa (str) The type of parity to use when sending data to the host. This may be one of 
"even", "odd", "none", "zero" (always set bit 8 to zero), "one" (always set bit 8 to 1). 
The default is even parity. 

pn (str) Telephone number(s) for this host. If the telephone number field contains an ® sign, 
tip searches the file /etc/ phones file for a list of telephone numbers; c.f. pAone*(5). 

tc (str) Indicates that the list of capabilities is continued in the named description. This is 

used primarily to share common capability information. 
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Here is a short example showing the use of the capability continuation feature: 

UNIX.1200:\ 

:dv=/dev/cauG:el=*D*U'C*S*Q'0®:du:at=ventel:ie=#$%:oe= D:br#1200: 
arpavax|ax:\ 

:pn=7654321%:tc=UNIX-1200 

FILES 

/etc/remote 

SEE ALSO 

tip(lC), phones(5) 
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NAME 

sccsfile - format of SGCS file 

DESCRIPTION 

An sees file b an ASCII file. It consists of six logical parts: the checksum, the delta table (con- 
tains information about each delta), user names (contains login names and/or numerical group 
IDs of users who may add deltas), flags (contains definitions of internal keywords), comments 
(contains arbitrary descriptive information about the file), and the body (contains the actual text 
lines intermixed with control lines). 

Throughout an SCCS file there are lines which begin with the ASCII SOH (start of heading) char- 
acter (octal 001). This character is hereafter referred to as the control character and will be 
represented graphically as Q. Any line described below which is not depicted as beginning with 
the control character is prevented from beginning with the control character. 

Entries of the form DDDDD represent a five digit string (a number between 00000 and 99999). 

Each logical part of an SCCS file is described in detail below. 

Checksum 

The checksum is the first line of an SCCS file. The form of the line is: 

©hDDDDD 

The value of the checksum is the sum of all characters, except those of the first line. The 
®h provides a magic number of (octal) 064001. 

Delta table 

The delta table consists of a variable number of entries of the form: 
®B DDDDD/DDDDD/DDDDD 

®d <type> <SCCS ID> yr/mo/da hr:mi;se <pgmr> DDDDD DDDDD 
®i DDDDD ... 
@x DDDDD ... 
®g DDDDD ... 
®m <MR number> 



®e <comments> 



The first line (Qs) contains the number of lines inserted/deleted/unchanged respectively. 
The second tine (®d) contains the type of the delta (currently, normal: D, and removed: 
R), the SCCS ID of the delta, the date and time of creation of the delta, the login name 
corresponding to the real user ID at the time the delta was created, and the serial 
numbers of the delta and its predecessor, respectively. 

The @i, ®x, and @g lines contain the serial numbers of deltas included, excluded, and 
ignored, respectively. These lines are optional. 

The @m lines (optional) each contain one MR number associated with the delta; the @c 
lines contain comments associated with the delta. 

The @e line ends the delta table entry. 
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User names 

The list of login names and/or numerical group IDs of users who may add deltas to the 
file, separated by new-lines. The lines containing these login names and/or numerical 
group IDs are surrounded by the bracketing lines @u and ®U. An empty list allows any- 
one to make a delta. 



Flags 



Keywords used internally (see admin{\) for more information on their use). Each flag line 
takes the form: 

©f <flag> <optional text> 



The following flags 


1 are defined: 


Oft 


<type of program > 


Qfv 


< program name> 


Qfi 




Qfb 




Qfm 


< module name> 


Off 


< floor > 


Qfc 


<ceiling> 


Qfd 


<default-sid> 


Ofn 




Ofj 




Qfl 


<lock-relea8es> 


Qfq 


<user deflned> 



The t flag defines the replacement for the identification keyword. The v flag controls 
prompting for MR numbers in addition to comments; if the optional text is present it 
deflnes an MR number validity checking program. The i flag controls the warning/error 
aspect of the "No id keywords" message. When the I flag is not present, this message is 
only a warning; when the i flag is present, this message will cause a "fatal" error (the file 
will not be gotten, or the delta will not be made). When the b flag is present the -b 
keyletter may be used on the gtt command to cause a branch in the delta tree. The m 
flag defines the first choice for the replacement text of the sccsfile.S identification key- 
word. The f flag defines the "floor" release; the release below which no deltas may be 
added. The e flag defines the "ceiling" release; the release above which no deltas may be 
added. The d flag defines the default SID to be used when none is specified on a gtt com- 
mand. The n flag causes delta to insert a "null" delta (a delta that applies no changes) 
in those releases that are skipped when a delta is made in a new release (for example, 
when delta 5.1 is made after delta 2.7, releases 3 and 4 are skipped). The absence of the 
n flag causes skipped releases to be completely empty. The J flag causes get to allow con- 
current edits of the same base SID. The 1 flag defines a list of releases that are locked 
against editing (ilfe((l) with the -e keyletter). The q flag defines the replacement for the 
%Q% identification keyword. 

Comments 

Arbitrary text surrounded by the bracketing lines ®t and ®T. The comments section 
typically will contain a description of the file's purpose. 

Body 

The body consists of text lines and control lines. Text lines don't begin with the control 
character, control lines do. There are three kinds of control lines: insert, delete, and end, 
represented by: 

QI DDDDD 
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@D DDDDD 
@E DDDDD 

respectively. The digit string is tbe serial number corresponding to the delta for the con- 
trol line. 

SEE ALSO 

adniin(l), delta(l), get(l), prs(l). 

Source Code Control System User's Guide by L. E. Bonanni and C. A. Salemi. 
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NAME 

servers - inet server data base 

DESCRIPTION 

The servers file contains the list of servers that inetd{S) operates. For each server a single line 
should be present with the following information: 

name of server 
protocol 
server location 

Items are separated by any number of blanks and/or tab characters. A "#" indicates the begin- 
ning of a comment; characters up to the end of the line are not interpreted by routines which 
search the file. 

The name of the server should be the official service name as contained in 8ervice8{b). The proto- 
col entry is either udp or tcp. The server location is the full path name of the server program. 

EXAMPLE 

The following example is taken from the Sun UNIX i^stem. 



tcp 


tcp /usr/etc/in.tcpd 


telnet 


tcp /usr/etc/in.telnetd 


shell 


tcp /etc/in .rshd 


login 


tcp /etc/in. rlogind 


exec 


tcp /usr/etc/in.rexecd 


ttcp 


udp /usr/etc/in.ttcpd 


syslog 


udp /usr/etc/in.syslog 


Comsat 


udp /usr/etc/in.comsat 


talk 


udp /usr/etc/in.talkd 


time 


tcp /usr/etc/in.timed 


FILES 




/etc/servers 




SEE ALSO 




8ervices(5), inetd(8) 
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NAME 

services - service name data base 

SYNOPSIS 

/etc/services 

DESCRIPTION 

The services file contains information regarding the known services available in the DARPA Inter- 
net. For each service a single line should be present with the following information: 

official service name 
port number 
protocol name 
aliases 

Items are separated by any number of blanks and/or tab characters. The port number and proto> 
col name are considered a single item; a "/" is used to separate the port and protocol (for 
instance, "512/tcp"). A "#" indicates the beginning of a comment; characters up to the end of 
the line are not interpreted by routines which search the file. 

Service names may contain any printable character other than a field delimiter, newline, or com- 
ment character. 

EXAMPLE 

Here is an example of the / etc/ services file from the Sun UNIX System. 

# 

# Network services, Internet style 

# 

echo 7/udp 

discard 9/udp sink null 

systat 11/tcp 

daytime 13/tcp 

netstat 15/tcp 

ftp 21/tcp 

telnet 23/tcp 

smtp 25/tcp mail 

time 37/tcp timserver 

name 42/tcp nameserver 

whois 43/tcp 

mtp 57/tcp # deprecated 

# 

# Host specific functions 

# 



ttyUnk 



tftp 


69/udp 


rje 


77/tcp 


finger 


79/tcp 


link 


87/tcp 


supdup 


95/tcp 


# 




# UNIX specific services 




# 




exec 


512/tcp 


login 


513/tcp 


shell 


514/tcp 


efs 


520/tcp 


biff 


512/udp 


who 


513/udp 



cmd 

Comsat 
whod 
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syslog 

talk 

route 




514/udp 
517/udp 
520/udp router routed# 521 also 


FILES 

/etc/services 






SEEAL30 

getservent(3N) 






BUGS 

A name server should be used instead of a static file. A binary indexed file format should be 
available for fast access. 
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NAME 

tar - tape archive file format 

DESCRIPTION 

Tar, (the tape archive command) dumps several files into one, in a medium suitable for transpor- 
tation. 

A "tar tape" or file b a series of blocks. Each block is of size TBLOCK. A file on the tape is 
represented by a header block which describes the file, followed by zero or more blocks which give 
the contents of the file. At the end of the tape are two blocks filled with binary zeros, as an end- 
of-file indicator. 

The blocks are grouped for physical I/O operations. Each group of n blocks (where n is set by 
the b key letter on the tar{\\ command line — default is 20 blocks) is written with a single ^stem 
call; on nine-track tapes, the result of this write is a single tape record. The last group is always 
written at the full size, so blocks after the two zero blocks contain random data. On reading, the 
specified or default group size is used for the first read, but if that read returns less than a full 
tape block, the reduced block size is used for further reads, unless the B key letter is used. 

The header block looks like: 



#define TBLOCK 


512 


#define NAMSIZ 


100 


union hblock { 




char dummy ITBLOCK]; 


struct headei 


{ 


char 


name|NAMSIZ|; 


char 


mode|8|; 


char 


uid|8l; 


char 


gid|8l; 


char 


8ize|l2 ; 


char 


mtime 12]; 


char 


chksum[8|; 


char 


linkflag; 


char 


linkname|NAMSIZ|; 



} dbuf; 

}: 

Name is a nult-terminated string. The other fields are zero-filled octal numbers in ASCII. Each 
field (of width w) contains w-2 digits, a space, and a null, except size and mtime, which do not 
contain the trailing null. Name is the name of the file, as specified on the tar command line. 
Files dumped because they were in a directory which was named in the command line have the 
directory name as prefix and /filename as suffix. Mode is the file mode, with the top bit masked 
off. Uid and gid are the user and group numbers which own the file. Size is the size of the file in 
bytes. Links and symbolic links are dumped with this field specified as zero. Mtime is the 
modification time of the file at the time it was dumped. Chkeum is a decimal ASCII value which 
represents the sum of all the bytes in the header block. When calculating the checksum, the 
chksum field is treated as if it were all blanks. Linkfiag is ASCII '0^ if the file is "normal" or a 
special file, ASCII '1' if it is an hard link, and ASCII '2' if it is a symbolic link. The name 
linked-to, if any, is in linkname, with a trailing null. Unused fields of the header are binary zeros 
(and are included in the checksum). 

The first time a given i-node number is dumped, it is dumped as a regular file. The second and 
subsequent times, it is dumped as a link instead. Upon retrieval, if a link entry is retrieved, but 
not the file it was linked to, an error message is printed and the tape must be manually re- 
scanned to retrieve the iinked-to file. 
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The encoding of the header is designed to be portable across machines. 

SEE ALSO 
tar(l) 

BUGS 

Names or linknames longer than NAMSIZ produce error reports and cannot be dumped. 
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NAME 

term - terminal driving tables for nroflf 

DESCRIPTION 

NroJff{l) uses driving tables to customize its output for various types of output devices, such as 
printing terminak, special word-processing terminals (such as Diablo, Qume, or NEC Spinwriter 
mechanisms), or special output filter programs. These driving tables are written as C programs, 
compiled, and installed in /usr/Ub/term/tabname , where name is the name for that terminal 
type as given in term{7). 

Here's how to construct a driver table for USG UNIX "nroff", in 25 easy lessons. The only 
changes for the V7 nroff (on 4.xBSD as well) are that the "iton" and "itoCT entries are missing, 
the "bset" and "breset* entries affect the "sg^flags" word in the "sgtty" structure, and the pro- 
cedures for making the table are different. 

Special thanks to the people at AT&T responsible for the UNIX documentation, without whose 
help this posting would not have been necessary. The structure of the tables is as follows: 

#define INCH 240 



struct { 

int bset; 

int breset; 

int Hor; 

int Vert; 

int Newline; 

int Char; 

int Em; 

int Halfline; 

int Adj; 

char *twinit; 

char *twrest; 

char *twnl; 

char ♦hir; 

char ♦hlf; 

char *flr; 

char *bdon; 

char *bdoff; 

char *iton; 

char *itoff; 

char *ploton; 

char *plotoff; 

char *up; 

char *down; 

char *right; 

char *left; 

char *codetab[256-32]; 

char *zzz; 
}t; 

The meanings of the various fields are as follows: 

bset bits to set in the c_oflag field of the termio structure (see tty{4)) before output. 

breset bits to reset in the c^oflag field of the termio structure before output. 

Hor horizontal resolution in fractions of an inch. 

Vert vertical resolution in fractions of an inch. 
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Newline space moved by a newline (linefeed) character in fractions of an inch. 

Char quantum of character sizes, in fractions of an inch, (that is, a character is a multiple 

of Char units wide) 

Em size of an em in fractions of an inch. 

Halfline space moved by a half-linefeed (or half-reverse-linefeed) character in fractions of an 
inch. 

Adj quantum of white space, in fractions 6f an inch, (that is, white spaces are a multiple 

of Adj units wide) 

Note: if this is less than the size of the space character (in units of Char; see below for 
how the sizes of characters are defined), nroff will output fractional spaces using plot 
mode. Also, if the -^ switch to nroff is used, Adj is set equal to Hor by nroff. 

twinit set of characters used to initialize the terminal in a mode suitable for nroff. 

twrest set of characters used to restore the terminal to normal mode. 

twni set of characters used to move down one line. 

hlr set of characters used to move up one-half line. 

hlf set of characters used to move down one-half line. 

fir set of characters used to move up one line. 

bdon set of characters used to turn on hardware boldface mode, if any. 

bdoff set of characters used to turn off hardware boldface mode, if any. 

iton set of characters used to turn on hardware italics mode, if any. 

iioff set of characters used to turn off hardware italics mode, if any. 

ploion set of characters used to turn on hardware plot mode (for Diablo type mechanisms), if 
any. 

plotoff set of characters used to turn off hardware plot mode (for Diablo type mechanisms), if 
any. 

up set of characters used to move up one resolution unit (Vert) in plot mode, if any. 

down set of characters used to move down one resolution unit (Vert) in plot mode, if any. 

right set of characters used to move right one resolution unit (Hor) in plot mode, if any. 

left set of characters used to move left one resolution unit (Hor) in plot mode, if any. 

eodetab definitioii of characters needed to print an nroff character on the terminal. The first 
byte is the number of character units (Char) needed to hold the character; that is, 
"\001" is one unit wide, "\002" is two units wide, etc. The high-order bit (0200) is 
on if the character is to be underlined in underline mode (.ul). The rest of the bytes 
are the characters used to produce the character in question. If the character has the 
sign (0200) bit on, it is a code to move the terminal in plot mode. It is encoded as: 

0100 bit on. _ vertical motion. 

0100 bit off horizontal motion. 

040 bit on negative (up or left) motion. 

040 bit off positive (down or right) motion. 

037 bits number of such motions to make. 



zzz 



a zero terminator at the end. 
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All quantities which are in units of fractions of an inch should be expressed as 
INCH* num/denom, where num and denom are respectively the numerator and denominator of 
the fraction; that is, 1/48 of an inch would be written as "INCH/48". 

If any sequence of characters does not pertain to the output device, that sequence should be given 
as a null string. 

The source code for the terminal name is in /u8r/8rc/cmd/text/roflr.d/terms.d/tabname.e« 
When a new terminal type is added, the file maketernu.c should be updated to '#include' the 
source to that driving table; note that the various terminal types are grouped into "parts" 
labelled PARTI, PART2, and PARTS. If necessary, more parts can be added. Other changes 
necessary to maketertm.c are left as an exercise to the reader. The makefile terms.mk in that 
directory should then be updated. 



FILES 



/usr/Iib/term/tab nams driving tables 
tabname.c source for driving tables 

SEE ALSO 

troff(l), term(7) 
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NAME 

termcap - terminal capability data base 

SYNOPSIS 

/etc/termcap 

DESCRIPTION 

Termeap b a data base describing terminals, used, for example, by vi{l) and cur8e8{SX). Termi- 
nals are described in termeap by giving a set of capabilities which they have, and by describing 
how operations are performed. Padding requirements and initialization sequences are included in 
termeap. 

Each entry in the termeap file describes a terminal, and is a line consisting of a number of fields 
separated by ':' characters. The first entry for each terminal gives the names which are known 
for the terminal, separated by 'j' characters. The first name is always 2 characters long and is 
used by older version 6 systems which store the terminal type in a 16 bit word in a systemwide 
data base. The second name given is the most common abbreviation for the terminal, and the 
last name given should be a long name fully identifying the terminal. The second name should 
contain no blanks; the last name may well contain blanks for readability. Entries may continue 
onto multiple lines by giving a \ as the last character of a line, and empty fields may be included 
for readability. 

Capabilities in termeap are all introduced by two-character codes, and are of three types: 

Boolean capabilities indicate that the terminal has some particular feature. Boolean capabili- 
ties are simply written between the ':' characters, and are indicated by the word 'bool' 
in the typ@ column of the capabilities table below. 

Numeric capabilities supply information such as the size of the terminal or the size of particular 
delays. Numeric capabilities are indicated by the word 'num' in the type column of 
the capabilities table below. Numeric capabilities are given by the two-character 
capability code followed by the '#' character and then the numeric value. For exam- 
ple: :eo#80: is a numeric entry stating that this terminal has 80 columns. 

Siring capabilities give a sequence which can be used to perform particular terminal opera- 
tions such as cursor motion. String valued capabilities are indicated by the word 'str' 
Is the typ@ column of the capabilities table below. String valued capabilities are 
given by the two-character capability code followed by an '=' sign and then a string 
ending at the next following ':'. For example, :ce=16\E''S: is a sample entry for 
clear to end-of-line. 

CAPABILITIES 

(P) indicates padding may be specified 

(P*^) indicates that padding may be based on the number of lines affected 

Name Type Pad? Description 

End alternate character set 

Add new blank line 

Terminal has automatic margins 

Start alternate character set 

Backspace if not 'H 

Terminal can backspace with "^H 

Back tab 

Backspace wraps from column to last column 

Command character in prototype if terminal settable 

Clear to end of display 

Clear to end of line 

Like cm but horizontal motion only, line stays same 

Clear screen 

Carsor motion 



Last change: 16 December 1983 65 



ae 


str 


(P) 


al 


str 


(P*) 


am 


bool 




as 


str 


(P) 


be 


str 




bs 


bool 




bt 


str 


(P) 


bw 


boo! 




CC 


str 




cd 


str 


(P*) 


ce 


str 


(P) 


ch 


str 


(P) 


cl 


str 


(P*) 


cm 


str 


(P) 
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CO 


num 




cr 


sir 


(p*) 


cs 


8tr 


(p) 


cv 


str 


(p) 


da 


bool 




dB 


num 




db 


bool 




dC 


num 




dc 


str 


(p*) 


dF 


num 




dl 


str 


(p*) 


dm 


str 




dN 


num 




do 


str 




dT 


num 




ed 


str 




ei 


str 




CO 


str 




ff 


str 


(?•) 


he 


bool 




hd 


str 




ho 


str 




hu 


str 




hz 


str 




ic 


str 


(p) 


if 


str 




im 


bool 




in 


bool 




ip 


str 


(p*) 


is 


str 




k0-k9 


str 




kb 


str 




kd 


str 




ke 


str 




kh 


str 




kl 


str 




kn 


num 




ko 


str 




kr 


str 




ks 


str 




ku 


str 




10-19 


str 




li 


num 




11 


str 




ma 


str 




md 


str 




me 


str 




mh 


str 




mi 


bool 




ml 


str 




mr 


str 




ms 


bool 




mu 


str 
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Number of columns in a line 

Carriage return, (default ^M) 

Change scrolling region (vtlOO), like cm 

Like ch but vertical only. 

Display may be retained above 

Number of millisec of bs delay needed 

Display may be retained below 

Number of millisec of cr delay needed 

Delete character 

Number of millisec of ff delay needed 

Delete line 

Delete mode (enter) 

Number of millisec of nl delay needed 

Down one line 

Number of millisec of tab delay needed 

End delete mode 

End insert mode; give ":ei=:" if Ic 

Can erase overstrikes with a blank 

Hardcopy terminal page eject (default *L) 

Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 

Home cursor (if no cm) 

Half-line up (reverse 1/2 linefeed) 

Hazeltine; can't print ~'s 

Insert character 

Name of file containing is 

Insert mode (enter); give ":ims:" if ic 

Insert mode distinguishes nulb on display 

Insert pad after character inserted 

Terminal initialization string 

Sent by "other" function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 

Out of "keypad transmit" mode 

Sent by home key 

Sent by terminal left arrow key 

Number of "other" keys 

Termcap entries for other non-function keys 

Sent by terminal right arrow key 

Put terminal in "keypad transmit" mode 

Sent by terminal up arrow key 

Labels on "other" function keys 

Number of lines on screen or page 

Last line, first column (if no cm) 

Arrow key map, used by vi version 2 only 

Enter bold mode 

Turn off all attributes, normal mode 

Enter dim mode 

Safe to move while in insert mode 

Memory lock on above cursor. 

Enter reverse mode 

Safe to move while in standout and underline mode 

Memory unlock (turn off memory lock). 
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No correctly working carriage return (DM2500,H2000) 

Non-destructive space (cursor right) 

Newline character (default \n) 

Terminal is a CRT but doesn't scroll. 

Terminal overstrikes 

Pad character (rather than null) 

Has hardware tabs (may need to be set with is) 

End stand out mode 

Scroll forwards 

Number of blank chars left by so or se 

Begin stand out mode 

Scroll reverse (backwards) 

Tab (other than ''I or with padding) 

Entry of similar terminal - must be last 

String to end programs that use cm 

String to begin programs that use cm 

Underscore one char and move past it 

End underscore mode 

Number of blank chars left by us or ue 

Terminal underlines even though it doesn't overstrike 

Upline (cursor up) 

Start underscore mode 

Visible bell (may not move cursor) 

Sequence to end open/visual mode 

Sequence to start open/visual mode 

Beehive (fl=escapc, f2=ctrl C) 

A newline is ignored after a wrap (Concept) 

Return acts like ce \r \n (Delta Data) 

Standout not erased by writing over it (HP 264?) 

Tabs are destructive, magic so char (Teleray 1061) 

A Sample Entry 

The following entl^, which describes the Concept-lOd, is among the more complex entries in the 
termcap file as of this writing. This particular concept entry is outdated, and is used as an exam- 
ple only. ^. 

cl I clOO I conceptlOO:is=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eo&\200:\ 

:al=3*\E*R:am:bs:cd=16*\E*C:ce=16\E*S:cl=2* L:cm=\Ea%+ %+ :co#80:\ 

:dc=16\E*A:dl«=3*\E*B:ei=\E\200:eo:im=\ET:in:ip=16*:li#24:mi:nd=\E=:\ 

i8e=\Ed\Ee:80=\ED\EE:ta=8\t:ul:up=\E;:vb=\Ek\EK:xn: 

Entries may continue.;Onto multiple lines by giving a \ as the last character of a line, and empty 
fields may be included for readability (here between the last field on a line and the first field on 
the next). 

Types of Capabilities 

Capabilities in termcap are of three types: Boolean capabilities which indicate that the terminal 
has some particular feature, numeric capabilities giving the size of the terminal or the size of par- 
ticular, delays, and string capabilities, which give a sequence which can be used to perform partic- 
ular terminal operations. All capabilities have two letter codes. 

Boolean capabilities are introduced simply by stating the two-character capability code in the 
field between ':' characters. For instance, the fact that the Concept has "automatic 
margins" (that is, an automatic return and linefeed when the end of a line is reached) 
is indicated by the capability am. Hence the description of the Concept includes am. 
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nc 


bool 




nd 


str 




nl 


str 


(p« 


ns 


bool 




OS 


bool 




pc 


str 




pt 


bool 




se 


str 




sf 


str 


(p) 


sg 


num 




so 


str 




Sf 


str 


(p) 


ta 


str 


(p) 


tc 


str 




te 


str 




tl 


str 




uc 


str 




ue 


str 




iig 


num 




ul 


bool 




up 


str 




us 


str 




vb 


str 




ve 


str 




vs 


str 




xb 


bool 




XB 


bool 




xr 


bool 




xs 


bool 




xt 


bool 
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Numeric capabilities are followed by the character '#' and then the value. Thus co which indi- 
cates the number of columns the terminal has gives the value '80' for the Concept. 

String valued capabilities, such as ce (clear to end of line sequence) are given by the two 
character code, an '=', and then a string ending at the next following ':'. A delay in 
milliseconds may appear after the '=' in such a capability, and padding characters are 
supplied by the editor after the remainder of the string is sent to provide this delay. 
The delay can be either a integer, for instance, '20', or an integer followed by an '*', 
that is, '3*'. A '*' indicates that the padding required is proportional to the number 
of lines affected by the operation, and the amount given is the per-affected-unit pad- 
ding required. When a '*' is specified, it is sometimes useful to give a delay of the 
form '3.5' to specify a delay per unit to tenths of milliseconds. 

A number of escape sequences are provided in the string valued capabilities for easy 
encoding of characters there. A \E maps to an ESCAPE character, "x maps to a 
control-x for any appropriate x, and the sequences \n \r \t \b \f give a newline, 
return, tab, backspace and formfeed. Finally, characters may be given as three octal 
digits after a \, and the characters ^ and \ may be given as \' and \\. If it is neces- 
saiy to place a i in a capability it must be escaped in octal as \072. If it is necessary 
to place a null character in a string capability it must be encoded as \200. The rou- 
tines which deal with termcap use C strings, and strip the high bits of the output very 
late so that a \200 comes out as a \000 would. 

Preparing DeBeriptioni 

We now outline how to prepare descriptions of terminals. The most effective way to prepare a 
terminal description is by imitating the description of a similar terminal in termcap and to build 
up a description gradually, using partial descriptions with ex to check that they are correct. Be 
aware that a very unusual terminal may expose deficiencies in the ability of the termcap file to 
describe it or bugs in ex. To easily test a new terminal description you can set the environment 
variable TERMCAP to a pathname of a file containing the description you are working on and 
the editor will look there rather than in /etc/termcap. TERMCAP can also be set to the termcap 
entry itself to avoid reading the file when starting up the editor. 

Basic capabU|tieli 

The nuitlb^t* of cdlilmns on eacli lidl for the terminal is given by the eo numeric capability. If 
the terminal is a CRT, then the number of lines on the screen is given by the 11 capability. If the 
terminal wraps around to the beginning of the next line when it reaches the right margin, then it 
should have the am capability. If the terminal can clear its screen, then this is given by the d 
string capability. If the terminal can backspace, then it should have the bs capability, unless a 
backspace is accomplished by a character other than 'H (ugh) in which case you should give this 
character as the be string capability. If it overstrikes (rather than clearing a position when a 
character is struck over) then it should have the os capability. 

A very important point here is that the local cursor motions encoded in termcap are undefined at 
the left and top edges of a CRT terminal. The editor will never attempt to backspace around the 
left edge, nor will it attempt to go up locally off the top. The editor assumes that feeding off the 
bottom of the screen will cause the screen to scroll up, and the am capability tells whether the 
cursor sticks at the right edge of the screen. If the terminal has switch selectable automatic mar- 
gins, the termcap file usually assumes that this is on, that is, am. 

These capabilities suffice to describe hardcopy and "glass-tty" terminals. Thus the model 33 tele- 
type is described as 

t3|33|tty33:co#72:os 

while the Lear Siegler ADM-3 is described as 
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cl I adm3|3|Isi a(im3:am:bs:cl=^Z:li#24:co#80 

Cursor addressing 

Cursor addressing in the terminal is described by a cm string capability, with printf{3S) like 
escapes %x in it. These substitute to encodings of the current line or column position, while 
other characters are passed through unchanged. If the cm string is thought of as being a func- 
tion, then its arguments are the line and then the column to which motion is desired, and the % 
encodings have the following meanings: 

%d as in print/, origin 

%2 like %2d 

%3 like%3d 

%. like %c 

%-f X adds X to value, then %. 

%>xy if value > x adds y, no output. 

%T reverses order of line and column, no output 

%i increments line/column (for 1 origin) 

%% gives a single % 

%n exclusive or row and column with 0140 (DM2500) 

%B BCD (16*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2*(x%16)), no output. (Delta Data). 

Consider the HP 2645, which, to get to row 3 and column 12, needs to be sent \E&al2c03Y pad- 
ded for 6 milliseconds. Note that the order of the rows and columns is inverted here, and that 
the row and column are printed as two digits. Thus its cm capability is 
*'cm=6\E&%r%2c%2Y'*. The Microterm ACT-IV needs the current row and column sent pre- 
ceded by a *T, with the row and column simply encoded in binary, "cm=*T%.%.". Terminals 
which use "%." need to be able to backspace the cursor (bs or be), and to move the cursor up 
one line on the screen (up introduced below). This is necessary because it is not always safe to 
transmit \t, \n "D and \r, as the system may change or discard them. 

A final example is t^e LSI ADM-3a, which uses row and column offset by a blank character, thus 
••cm«:\E«%+ %+ ". 

Cursor motions z.. 

If the terminal can move the cursor one position to the right, leaving the character at the current 
petition unchanged, then this sequence should be given as nd (non-destructive space). If it can 
move the cursor up a line on the screen in the same column, this should be given as up. If the 
terminsJ has no cursor addressing capability, but can home the cursor (to very upper left corner 
of screen) then this can be given as ho; similarly a fast way of getting to the lower left hand 
corner can be given as 11; this may involve going up with up from the home position, but the edi- 
tor will never do this itself (unless 11 does) because it makes no assumption about the effect of 
moving up from thb home position. 

Area clears 

If the terminal can clear from the current position to the end of the line, leaving the cursor where 
it is, this should be given as ce. If the terminal can clear from the current position to the end of 
the display, then this, should be given as cd. The editor only uses cd from the first column of a 
line. t-: 

Insert/delete line 

If the terminal can open a new blank line before the line where the cursor is, this should be given 
as al; this is done only from the first position of a line. The cursor must then appear on the 
newly blank line. If the terminal can delete the line which the cursor is on, then this should be 
given as dl; this is done only from the first position on the line to be deleted. If the terminal can 
scroll the screen backwards, then this can be given as sb, but just al suffices. If the terminal can 
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retain display memory above then the da capability should be given; if display memory can be 
retained below then db should be given. These let the editor understand that deleting a line on 
the screen may bring non-blank lines up from below or that scrolling back with sb may bring 
down non-blank lines. 

Insert/delete character 

There are two basic kinds of intelligent terminab with respect to insert/delete character which 
can be described using termcap. The most common insert/delete character operations affect only 
the characters on the current line and shift characters off the end of the line rigidly. Other termi- 
nals, such as the Concept 100 and the Perkin Elmer Owl, make a distinction between typed and 
untyped blanks on the screen, shifting upon an insert or delete only to an untyped blank on the 
screen which is either eliminated, or expanded to two untyped blanks. You can find out which 
kind of terminal you have by clearing the screen and then typing text separated by cursor 
motions. Type "abc def" using local cursor motions (not spaces) between the "abc" and the 
^'def. Then position the cursor before the "abc'Vand put the terminal in insert mode. If typing 
characters causes the rest of the line to shift rigidly and characters to fall off the end, then your 
terminal does not distinguish between blanks and untyped positions. If the "abc" shifts over to 
the "def" which then move together around the end of the current line and onto the next as you 
insert, you have the second type of terminal, and should give the capability in, which stands for 
"insert null". If your terminal does something different and unusual then you may have to 
modify the editor to get it to use the insert mode your terminal defines. We have seen no termi- 
nals which have an insert mode not not falling into one of these two classes. 

The editor can handle both terminals which have an insert mode, and terminals which send a sim- 
ple sequence to open a blank position on the current line. Give as Im the sequence to get into 
insert mode, of give it an empty value if your terminal uses a sequence to insert a blank position. 
Give as el the sequence to leave insert mode (give this, with an empty value also if you gave Im 
so). Now give as Ic any sequence needed to be sent just before sending the character to be 
inserted. Most terminals with a true insert mode will not give Ic, terminals which send a 
sequence to open a screen position should give it here. (Insert mode is preferable to the sequence 
to open a position oh the screen if your terminal has both.) If post insert padding is needed, give 
this as a number of milliseconds in Ip (a string option). Any other sequence which may need to 
be sent after an insert of a single character may also be given in Ip. 

It is occasionally necessary to move around while in insert mode to delete characters on the same 
line (for example, if there is a tab after the insertion position). If your terminal allows motion 
while in insert mode you can give the capability ml to speed up inserting in this case. Omitting 
ml will affect only speed. Some terminals (notably Datamedia's) must not have ml because of 
the way their insert mode works. 

Finally, you can specify delete mode by giving dm and ed to enter and exit delete mode, and dc 
to delete a single character while in delete mode. 

Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout mode these can be given as so and se 
respectively. If there are several flavors of standout mode (such as inverse video, blinking, or 
underlining - half bright is not usually an acceptable "standout" mode unless the terminal is in 
inverse video mode constantly) the preferred mode is inverse video by itself. If the code to 
change into or out of standout mode leaves one or even two blank spaces on the screen, as the 
TVI 912 and Teieray 1061 do, then ug should be given to tell how many spaces are left. 

Codes to begin underfilling and end underlining can be given as us and ue respectively. If the 
terminal has a code to underline the current character and move the cursor one space to the right, 
such as the Microterm Mime, this can be given as uc. (If the underline code does not move the 
cursor to the right, giy^.the code followed by a nondestructive space.) 



70 Last change: 16 December 1983 Sun Release 1.1 



TERMCAP ( 5 ) FILE FORMATS TERMCAP ( 5 ) 



Many terminab, such as the HP 2621, automatically leave standout mode when they move to a 
new line or the cursor is addressed. Programs using standout mode should exit standout mode 
before moving the cursor or sending a newline. 

If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) 
then this can be given as vb; it must not move the cursor. If the terminal should be placed in a 
different mode during open and visual modes of ex, this can be given as vs and ve, sent at the 
start and end of these modes respectively. These can be used to change, for example, from a 
underline to a block cursor and back. 

If the terminal needs to be in a special mode when running a program that addresses the cursor, 
the codes to enter and exit this mode can be given as tl and te. This arises, for example, from 
terminals like the Concept with more than one page of memory. If the terminal has only memory 
relative cursor addressing and not screen relative cursor addressing, a one screen-sized window 
must be fixed into the terminal for cursor addressing to work properly. 

If your terminal correctly generates underlined characters (with no special codes needed) even 
though it does not overstrike, then you should give the capability ul. If overstrikes are erasable 
with a blank, then this should be indicated by giving eo. 

ANSI terminals have modes for the character highlighting. Dim characters may be generated in 
dim mode, entered by mh; reverse video characters in reverse mode, entered by mr; bold charac- 
ters in bold mode, entered by md; and normal mode characters restored by turning off all attri- 
butes with me. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are pressed, this information can 
be given. Note that it is not possible to handle terminals where the keypad only works in local 
(this applies, for example, to the unshifted HP 2621 keys). If the keypad can be set to transmit 
or not transmit, give these codes as ks and ke. Otherwise the keypad is assumed to always 
transmit. The codes sent by the left arrow, right arrow, up arrow, down arrow, and home keys 
can be given as klf kr, kU| kd, and kh respectively. If there are function keys such as fO, fl, ..., 
f9, the codes they send can be given as kOy kl, •„, kO. If these keys have labels other than the 
default fO through f9, the labels can be given as 10, 11, ..., 10. If there are other keys that 
transmit the same code as the terminal expects for the corresponding function, such as clear 
screen, the termcap 2 letter codes can be given in the ko capability, for example, 
":ko=cl,ll,sf,sb:", which says that the terminal has clear, home down, scroll down, and scroll up 
keys that transmit the same thing as the cl, 11, sf, and sb entries. 

The ma entry is also used to indicate arrow keys on terminals which have single character arrow 
keys. It is obsolete but still in use in version 2 of vi, which must be run on some minicomputers 
due to memory limitations. This field is redundant with kl, kr, ku, kd, and kh. It consists of 
groups of two characters. In each group, the first character is what an arrow key sends, the 
second character is the corresponding vi command. These commands are h for kl, J for kd, k for 
ku, 1 for kr, and H for kh. For example, the mime would be :ma^'KJ"Zk'Xl: indicating 
arrow keys left (*H), down (*K), up (*Z), and right (*X). (There is no home key on the mime.) 

Mlscellaneoui 

If the terminal requires other than a null (zero) character as a pad, then this can be given as pc. 

If tabs on the terminal require padding, or if the terminal uses a character other than 'I to tab, 
then this can be given as ta. 

Hazeltine terminals, which don't allow '"' characters to be printed should indicate hz. Datamedia 
termmals, which echo carriage-return linefeed for carriage return and then ignore a following 
linefeed should indicate ne. Early Concept terminals, which ignore a linefeed immediately after 
an am wrap, should indicate xn. If an erase-eol is required to get rid of standout (instead of 
merely writing on top of it), xs should be given. Teleray terminals, where tabs turn all characters 
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moved over to blacks, should indicate 3Et. Other specific terminal problems may be corrected by 
adding more capabilities of the form xx. 

Other capabilities include is, an initialization string for the terminal, and if, the name of a file 
containing long initialization strings. These strings are expected to properly clear and then set 
the tabs on the terminal, if the terminal has settable tabs. If both are given, b will be printed 
before if. This is useful where if is /uer/lib/tabset/std but ia clears the tabs first. 

Similar Terminals 

If there are two very similar terminals, one can be defined aus being just like the other with certain 
exceptions. The string capability te can be given with the name of the similar terminal. This 
capability must be last and the combined length of the two entries must not exceed 1024. Since 
termlib routines search the entry from left to right, and since the tc capability is replaced by the 
corresponding entry, the capabilities given at the left override the ones in the similar terminal. A 
capability can be canceled with xxO where xx is the capability. For example, the entry 

hn 1 2621nl:ksQ:keQ:tc=:2621: 

defines a 2621nl that does not have the Ics or Ice capabilities, and hence does not turn on the 
function key labels when in visual mode. This is useful for different modes for a terminal, or for 
different user preferences. 



FILES 



/etc/termcap file containing terminal descriptions 

SEE ALSO 

ex(l), cur8es(3X), termcap(3X), tset(l), vi(l), ul(l), more(l) 

BUGS 

Ex allows only 256 characters for string capabilities, and the routines in termeap{SX) do not check 
for overflow of this buffer. The total length of a single entry (excluding only escaped newlines) 
may not exceed 1024. 

The ma, vs, and ve entries are specific to the vi program. 

Not all programs support all entries. There are entries that are not supported by any program. 
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NAME 

tp - DEC/mag tape formats 

DESCRIPTION 

Tp dumps files to and extracts files from DECtape and magtape. The formats of these tapes are 
the same except that magtapes have larger directories. 

Block zero contains a copy of a stand-alone bootstrap program. See reboot{S). 

Blocks 1 through 24 for DECtape (1 through 62 for magtape) contain a directory of the tape. 
There are 192 (resp. 496) entries in the directory; 8 entries per block; 64 bytes per entry. Each 
entry has the following format: 

struct { 

char pathname[32|; 

unsigned short mode; 

char uid; 

char gid; 

char unusedl; 

char size[3|; 

long modtime; 

unsigned short tapeaddr; 

char unused2(l6]; 

unsigned short checksum; 

}i 

The path name entry is the path name of the file when put on the tape. If the pathname starts 
with a zero word, the entry is empty. It is at most 32 bytes long and ends in a null byte. Mode, 
uid, gid, size and time modified are the same as described under i-nodes (see file system /&(5)). 
The tape address is the tape block number of the start of the contents of the file. Every file 
starts on a block boundary. The file occupies (size+ 511)/512 blocks of continuous tape. The 
checksum entry has a value such that the sum of the 32 words of the directory entry is zero. 

Blocks above 25 (resp. 63) are available for file storage. 

A fake entry has a size of zero. 

SEE ALSO 

fs(5), tp(l) 

BUGS 

The pathname, uid, gid, and size fields are too small. 
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NAME 

ttys - terminal initialization data 

DESCRIPTION 

The ttye file is read by the init program and specifies which terminal special files are to have a 
process created for them so that people can log in. There is one line in the ttys file per special file 
associated with a terminal. 

The first character of a line in the ttys file is either '0' or '1*. If the first character on the line is a 
'0', the init program ignores that line. If the first character on the line is a '1', the init program 
creates a login process for that line. 

The second character on each line is used as an argument to getty{S), which performs such tasks 
as baud-rate recognition, reading the login name, and calling login. For normal lines, the second 
character is '0'; other characters can be used, for example, with hard-wired terminals where speed 
recognition is unnecessary or which have special characteristics. The remainder of the line is the 
terminal's entry in the device directory, /dev. 

Getty uses the second character in the ttys file to look up the characterbtics of the terminal in the 
fetc/gettytab file. Consult the gettytab{b) manual page for an explanation of the layout of 
fetc/gettytab. 

FILES 

/etc/ttys 

SEE ALSO 

init(8), getty(8), login(l), gettytab(5) 
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NAME 

ttytype - data base of terminal types by port 

SYNOPSIS 

/ctc/ttytype 

DESCRIPTION 

Ttytype is a database containing, for each tty port on the system, the kind of terminal that is 
attached to it. There is one line per port, containing the terminal kind (as a name listed in 
termcap (5)), a space, and the name of the tty, minus /dev/. 

This information is read by t8et{i) and by login{l) to initialize the TERM variable at login time. 

SEE ALSO 

t8et(l), login(l) 

BUGS 

Some lines are merely known as "dialup" or "plugboard". 
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NAME 

uuencode - format of an encoded uuencode file 

DESCRIPTION 

Files output by uuencode(lC) consist of a header line, followed by a number of body lines, and a 
trailer line. Uudecode will ignore any lines preceding the header or following the trailer. Lines 
preceding a header must not, of course, look like a header. 

The header line is distinguished by having the first 6 characters "begin ". The word begin is fol- 
lowed by a mode (in octal), and a string which names the remote file. Spaces separate the three 
items in the header line. 

The body consists of a number of lines, each at most 62 characters long (including the trailing 
newline). These consist of a character count, followed by encoded characters, followed by a new- 
line. The character count is a single printing character, and represents an integer, the number of 
bytes the rest of the line represents. Such integers are always in the range from to 63 and can 
be determined by subtracting the character space (octal 40) from the character. 

Groups of 3 bytes are stored in 4 characters, 6 bits per character. All are offset by a space to 
make the characters printing. The last line may be shorter than the normal 45 bytes. If the size 
is not a multiple of 3, this fact can be determined by the value of the count on the last line. 
Extra garbage will be included to make the character count a multiple of 4. The body b ter- 
minated by a line with a count of zero. Thb line consists of one ASCII space. 

The trailer line consists of "end" on a line by itself. 

SEE ALSO 

uuencode(lC), uudecode(lC), uusend(lC), uucp(lC), mail(l) 
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NAME 

vfont - font formats 

SYNOPSIS 

#lnclude < vfont. h> 

DESCRIPTION 

The fonts used by the window system and printer/plotters have the following format. Each font 
is in a file, which contains a header, an array of character description structures, and an array of 
bytes containing the bit maps for the characters. The header has the following format: 



struct header { 

short magic; 

unsigned short size; 

short maxx; 

short maxy; 

short xtend; 

); 

#definc VFONT_MAGIC 



/♦ Magic number VFONT_MAGIC */ 
/♦ Total # bytes of bitmaps */ 
/* Maximum horizontal glyph size */ 
/* Maximum vertical glyph size */ 
/* (unused) */ 

0436 



Maxx and maxy are intended to be the maximum horizontal and vertical size of any glyph in the 
font, in raster lines. (A glyph is just a printed representation of a character, in a particular size 
and font.) The eize is the total size of the bit maps for the characters in bytes. The xtend field is 
not currently used. 

After the header is an array of NUM_DISPATCH structures, one for each of the possible charac- 
ters in the fonti Eacli element of the array has the form: 



siliict dispatch { 

unsigned short addr; 

short nbytes; 

char up, down, left, right; 

short width; 

); 

#define NUM.DISPATCH 



/* &(glyph) - &(8tart of bitmaps) */ 
/* # bytes of glyphs (0 if no glyph) */ 
/* Widths from baseline point */ 
/* Logical width, used by troff */ 



256 



The nbytea field is nonzero for characters which actually exist. For such characters, the addr field 
is an offset into the bit maps to where the character's bit map begins. The up, down, left, and 
right fields are offsets from the base point of the glyph to the edges of the rectangle which the bit 
map represents. (The imaginary "base point" b a point which is vertically on the "base line" of 
the glyph (the bottom line of a glyph which doesn't have a descender) and horizontally near the 
left edge of the glyph; often 3 or so pixels past the left edge.) The bit map contains upi- down 
rows of data for the character, each of which has left-t right columns (bits). Each row is rounded 
up to a number of bytes. The width field represents the logical width of the glyph in bits, and 
shows the horizontal displacement to the base point of the next glyph. 

FILES 

/usr/lib/vfont/* 
/usr/suntool/fixedwidthfonts/* 

SEE ALSO 

troff(l), pti(l), vfontinfo(l), vswa^(l) 



BUGS 



A machine-independent font format should be defined. The shorts in the above structures con- 
tain different bit patterns depending whether the font file is for use on a Vax or a Sun. The 
V8wap program must be used to convert one to the other. 
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Interprocess Communication Primer 



This document provides an introduction to the interprocess communication facilities included in 
the Sun Workstation version of the UNDCf operating system. 

It discusses the overall model for interprocess communication and introduces the interprocess 
communication primitives which have been added to the system. The majority of the document 
considers the use of these primitives in developing applications. The reader is expected to be 
familiar with the C programming language as all examples are written in C. 



t UNIX is a trademark of Bell Laboratories. 
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1. Introduction 

One of the most important features added in the Berkeley 4.2 release of the UNIX operating 
system is substantial new interprocess communication facilities. These facilities are the result of 
more than two years of discussion and research. The facilities provided in thb release incor> 
porate many of the ideas from current research, while trying to maintain the UNIX philosophy 
of simplicity and conciseness. We hope that these interprocess communication facilities will 
establish a standard. From the response to the design, it appears that it is being adopted on 
many systems. 

UNIX has previously been very weak in the area of interprocess communication. Until recently, 
the only standard mechanism which allowed two processes to communicate were pipes (the mpx 
files which were part of Version 7 were experimental). Unfortunately, pipes are restrictive in 
that the two communicating processes must be related through a common ancestor. Further, 
the semantics of pipes makes them almost impossible to maintain in a distributed environment. 

Earlier attempts at extending the ipc facilities of UNIX have met with mixed reaction. The 
majority of the problems have been related to the fact these facilities have been tied to the 
UNIX file system; either through naming, or implementation. Consequently, the ipc facilities 
provided in this release have been designed as a totally independent subsystem, and allow 
processes to rendezvous in many ways. Processes may rendezvous through a UNIX file system- 
like name space (a space where all names are path names) as well as through a network name 
space. In fact, new name spaces may be added at a future time with only minor changes visible 
to users. Further, the communication facilities have been extended to included more than the 
simple byte stream provided by a pipe-like entity. These extensions have resulted in a com- 
pletely new part of the system which users will need time to familiarize themselves with. It is 
likely that as more use is made of these facilities they will be refined; only time will tell. 

The remainder of this document is organized in four sections. Section 2 introduces the new sys- 
tem calls and the basic model of communication. Section 3 describes some of the supporting 
library routines users may find useful in constructing distributed applications. Section 4 is con- 
cerned with the client/server model used in developing applications and includes examples of 
the two major types of servers. Section 5 delves into advanced topics which sophisticated users 
are likely to encounter when using the ipc facilities. 
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2. Basics 

The basic building block for communication is the socket A socket is an endpoint of communi- 
cation to which a name may be bound. Each socket in use has a type and one or more associ- 
ated processes. Sockets exist within communication domains. A communication domain is an 
abstraction introduced to bundle common properties of processes communicating through sock- 
ets. One such property is the scheme used to name sockets. For example, in the UNIX com- 
munication domain sockets are named with UNIX path names; e.g. a socket may be named 
"/dev/foo". Sockets normally exchange data only with sockets in the same domain (it may be 
possible to cross domain boundaries, but only if some translation process is performed). The ipc 
supports two separate communication domains: the UNIX domain, and the Internet domain is 
used by processes which communicate using the the DARPA standard communication protocols. 
The underlying communication facilities provided by these domains have a significant influence 
on the internal system implementation as well as the interface to socket facilities available to a 
user. An example of the latter is that a socket "operating" in the UNIX domain sees a subset 
of the possible error conditions which are possible when operating in the Internet domain. 

2.1. Socket Types 

Sockets are typed according to the communication properties visible to a user. Processes are 
presumed to communicate only between sockets of the same type, although there is nothing 
that prevents communication between sockets of different types should the underlying commun- 
ication protocols support this. 

Three types of sockets currently are available to a user. A stream socket provides for the 
bidirectional, reliable, sequenced, and unduplicated flow of data without record boundaries. 
Aside from the bidirectionality of data flow, a pair of connected stream sockets provides an 
interface nearly identical to that of pipes*. 

A datagram socket supports bidirectional flow of data which is not promised to be sequenced, 
reliable, or unduplicated. That is, a process receiving messages on a datagram socket may find 
messages duplicated, and, possibly, in an order different from the order in which it was sent. An 
important characteristic of a datagram socket is that record boundaries in data are preserved. 
Datagram sockets closely model the facilities found in many contemporary packet switched net- 
works such as the Ethernet. 

A raw socket provides users access to the underlyin| communication protocols which support 
socket abstractions. These sockets are normally datagram oriented, though their exact charac- 
teristics are dependent on the interface provided by the protocol. Raw sockets are not intended 
for the general user; they have been provided mainly for those interested in developing new 
communication protocols, or for gaining access to some of the more esoteric facilities of an exist- 
ing protocol. 

Two potential socket types which have interesting properties are the sequenced packet socket 
and the reliably delivered message socket. A sequenced packet socket is identical to a stream 
socket with the exception that record boundaries are preserved. This interface is very similar to 
that provided by the Xerox NS Sequenced Packet protocol. The reliably delivered message 
socket has similar properties to a datagram socket, but with reliable delivery. While these two 
socket types have been loosely defined, they are not currently implemented. So, in this 



• In the UNIX domain, in fact, the semantics are identical and, as one might expect, pipes have 
been implemented internally as simply a pur of connected stream sockets. 
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document, we will concern ourselves only with the three supported socket types. 

2.2. Socket Creation 

To create a socket the socket system call is used: 

s = socket(domain, type, protocol); 

This call requests that the system create a socket in the specified domain and of the specified 
type. A particular protocol may also be requested. If the protocol is left unspecified (a value of 
0), the system will select an appropriate protocol from those protocols which comprise the com- 
munication domain and which may be used to support the requested socket type. The user is 
returned a descriptor (a small integer number) which may be used in later system calls which 
operate on sockets. The domain is specified as one of the manifest constants defined in the file 
<gys/ socket. h>. For the UNIX domain the constant is AF_UNIX*; for the Internet domain 
AFJNET. The socket types are also defined in this file and one of SOCK.STREAM, 
SOCK_DGRAM, or SOCK_RAW must be specified. To create a stream socket in the Internet 
domain the following call might be used: 

s -= socket(AFJNET, SOCK.STREAM, 0); 

This call would result in a stream socket being created with the TCP protocol providing the 
underlying communication support. To create a datagram socket for on-machine use a sample 
call might be: 

s = socket(AF_UNIX, SOCK.DGRAM, 0); 

To obtain a particular protocol one selects the protocol number, as defined within the communi- 
cation domain. For the Internet domain the available protocols are defined in Knetinet/ in.h> 
or, better yet, one may use one of the library routines discussed in section 3, such as getproto- 
byname: 

^include <sys/types.h> 
^include <sys/socket.h> 
#include <netinet/in.h> 
#include <netdb.h> 

pp = getprotobyname(*' tcp" ); 

s = socket(AFJNET, SOCK^STREAM, pp->p_proto); 

There are several reasons a socket call may fail. Aside from the rare occurrence of lack of 
memory (ENOBUFS), a socket request may fail due to a request for an unknown protocol 
(EPROTONOSUPPORT), or a request for a type of socket for which there b no supporting 
protocol (EPROTOTYPE). 



* The manifest constants are named AF^whatever as they indicate the "address format" to use in 
interpreting names. 
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2.3. Binding Names 

A socket is created without a name. Until a name is bound to a socket, processes have no way 
to reference it and, consequently, no messages may be received on it. The bind call is used to 
assign a name to a socket: 

bind(s, name, namelen); 

The bound name is a variable length byte string which is interpreted by the supporting 
protocol(s). Its interpretation may vary from communication domain to communication domain 
(this is one of the properties which comprise the "domain"). In the UNIX domain names are 
path names while in the Internet domain names contain an Internet address and port number. 
If one wanted to bind the name "/dev/foo" to a UNIX domain socket, the following would be 
used: 

#include <sys/un.h> 
struct sockaddr__un sun; 
sun.sun_family =« AF_UNIX; 
strcpy(sun.sun_j)ath, "/dev/foo"); 
bind(s, fesun, strlen(" /dev/foo" )+ 2); 

In binding an Internet address things become more complicated. The actual call is simple, 

#include <sys/types.h> 
^include <netinet/in.h> 

struct sockaddr_jn sin; 

bind(s, &sin, sizeof (sin)); 

but the selection of what to place in the address sin requires some discussion. We will come 
back to the problem of formulating Internet addresses in section 3 when the library routines 
used in name resolution are discussed. 



2.4. Connection Ektablishment 

With a bound socket it is possible to rendezvous with an unrelated process. This operation is 
usually asymmetric with one process a "client" and the other a "server". The client requests 
services from the server by initiating a "connection" to the server's socket. The server, when 
willing to offer its advertised services, passively "listens" on its socket. On the client side the 
connect call is used to initiate a connection. Using the UNIX domain, this might appear as, 

struct sockaddr_un server; 

connect(s, feserver, strlen(server.sun_path)+ 2); 

while in the Internet domain, 

struct sockaddr_in server; 
connect(s, feserver, sizeof (server)); 

If the client process's socket is unbound at the time of the connect call, the system will 
automatically select and bind a name to the socket; c.f. section 5.4^. An error is returned when 



^ You rnyst do a get$oeknamc{2) call to retrieve the binding. 
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the connection was unsuccessful (any name automatically bound by the system, however, 
remains). Otherwise, the socket is associated with the server and data transfer may begin. 

Many errors can be returned when a connection attempt fails. The most common are: 

ETIMEDOUT 

After failing to establish a connection for a period of time, the system decided there was no 
point in retrying the connection attempt any more. This usually occurs because the desti- 
nation host is down, or because problems in the network resulted in transmissions being 
lost. 

ECONNREFUSED 

The host refused service for some reason. When connecting to a host running the 0.0 
release version of UNIX this is usually due to a server process not being present at the 
requested name. 

ENETDOWN or EHOSTDOWN 

These operational errors are returned based on status information delivered to the client 
host by the underlying communication services. 

ENETUNREACH or EHOSTUNREACH 

These operational errors can occur either because the network or host is unknown (no route 
to the network or host is present), or because of status information returned by intermedi- 
ate gateways or switching nodes. Many times the status returned is not sufficient to distin- 
guish a network being down from a host being down. In these cases the system is conservar 
tive and indicates the entire network is unreachable. 

For the server to receive a client's connection it must perform two steps after binding its socket. 
The first is to indicate a willingness to listen for incoming connection requests: 

listen(s, 5); 

The second parameter to the listen call specifies the maximum number of outstanding connec- 
tions which may be queued awaiting acceptance by the server process. Should a connection be 
requested while the queue is full, the connection will not be refused, but rather the individual 
messages which comprise the request will be ignored. This gives a harried server time to make 
room in its pending connection queue while the client retries the connection request. Had the 
connection been returned with the ECONNREFUSED error, the client would be unable to tell if 
the server was up or not. As it is now it is still possible to get the ETIMEDOUT error back, 
though this is unlikely. The backlog figure supplied with the listen call is limited by the system 
to a maximum of 5 pending connections on any one queue. This avoids the problem of 
processes hogging system resources by setting an infinite backlog, then ignoring all connection 
requests. 

With a socket marked as listening, a server may aceepi a connection: 

fromlen = sizeof (from); 

snew = accept(s, fefrom, fefromlen); 

A new descriptor is returned on receipt of a connection (along with a new socket). If the server 
wishes to find out who its client is, it may supply a buffer for the client socket's name. The 
value-result parameter fromlen is initialized by the server to indicate how much space is associ- 
ated with from, then modified on return to reflect the true size of the name. If the client's name 
is not of interest, the second parameter may be zero. 

Accept normally blocks. That is, the call to accept will not return until a connection is avail- 
able or the system call is interrupted by a signal to the process. Further, there is no way for a 
process to indicate it will accept connections from only a specific individual, or individuals. It is 
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up to the user process to consider who the connection is from and close down the connection if 
it does not wish to speak to the process. If the server process wants to accept connections on 
more than one socket, or not block on the accept call there are alternatives; they will be con- 
sidered in section 5. 

2.5. Data Transfer 

With a connection established, data may begin to flow. To send and receive data there are a 
number of possible calls. With the peer entity at each end of a connection anchored, a user can 
send or receive a message without specifying the peer. As one might expect, in this case, then 
the normal read and write system calls are useable, 

write(s, buf, sizeof (buf )); 
read(s, buf, sizeof (buf)); 

In addition to read and writCy the new calls send and recv may be used: 

send(s, buf, sizeof (buf), flags); 
recv(s, buf, sizeof (buf), flags); 

While send and recv are virtually identical to read and write, the extra flags argument is impor- 
tant. The flags may be specified as a non-zero value if one or more of the following is required: 

MSGjOOB send/receive out of band data 

MSGJPEEK look at data without reading 

MSG.DONTROUTE send data without routing packets 

Out of band data is a notion specific to stream sockets, and one which we will not immediately 
consider. The option to have data sent without routing applied to the outgoing packets is 
currently used only by the routing table management process, and is unlikely to be of interest 
to the casual user. The ability to preview data is, however, of interest. When MSG_PREVIEW 
is specified with a recv call, any data present is returned to the user, but treated as still 
"unread". That is, the next read or recv call applied to the socket will return the data previ- 
ously previewed. 

2.6. Discarding Sockets 

Once a socket is no longer of interest, it may be discarded by applying a close to the descriptor, 

close(s); 

If data is associated with a socket which promises reliable delivery (e.g. a stream socket) when a 
close takes place, the system will continue to attempt to transfer the data. However, after a 
fairly long period of time, if the data is still undelivered, it will be discarded. Should a user 
have no use for any pending data, it may perform a shutdown on the socket prior to closing it. 
This call is of the form: 

shutdown(s, how); 

where how is if the user is no longer interested in reading data, 1 if no more data will be sent, 
or 2 if no data is to be sent or received. Applying shutdown to a socket causes any data queued 
to be immediately discarded. 
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2.7. Connectionless Sockets 

To this point we have been concerned mostly with sockets which follow a connection oriented 
model. However, there is also support for connectionless interactions typical of the datagram 
facilities found in contemporary packet switched networks. A datagram socket provides a sym- 
metric interface to data exchange. While processes are still likely to be client and server, there 
is no requirement for connection establishment. Instead, each message includes the destination 
address. 

Datagram sockets are created as before, and each should have a name bound to it in order that 
the recipient of a message may identify the sender. To send data, the sendto primitive is used, 

sendto(s, buf, buflen, flags, &to, tolen); 

The *, buf, buflen, and flags parameters are used as before. The to and ioUn values are used to 
indicate the intended recipient of the message. When using an unreliable datagram interface, it 
is unlikely any errors will be reported to the sender. Where information is present locally to 
recognize a message which may never be delivered (for instance when a network is unreachable), 
the call will return -1 and the global value errno will contain an error number. 

To receive messages on an unconnected datagram socket, the reevfrom primitive is provided: 

recvfrom(s, buf, buflen, flags, Mrom, &fromlen); 

Once again, the fromlen parameter is handled in a value-result fashion, initially containing the 
size of the from buffer. 

!n addition to the two calls mentioned above, datagram sockets may also use the connect call to 
associate a socket with a specific address. In this case, any data sent on the socket will 
automatically be addressed to the connected peer, and only data received from that peer will be 
delivered to the user. Only one connected address is permitted for each socket (i.e. no multi- 
casting). Connect requests on datagram sockets return immediately, as this simply results in 
the system recording the peer's address (as compared to a stream socket where a connect 
request initiates establishment of an end to end connection). Other of the less important details 
of datagram sockets are described in section 5. 

2.8. Input/Output Multiplexing 

One last facility often used in developing applications is the ability to multiplex i/o requests 
among multiple sockets and/or files. This is done using the telect call: 

select(nfds, fereadfds, fewritefds, &execptfds, &timeout); 

Select takes as arguments three bit masks, one for the set of file descriptors for which the caller 
wishes to be able to read data on, one for those descriptors to which data is to be written, and 
one for which exceptional conditions are pending. Bit masks are created by or-ing bits of the 
form "1 << fd". That is, a descriptor fd is selected if a 1 is present in the /<fth bit of the 
mask. The parameter nfds specifies the range of file descriptors (i.e. one plus the value of the 
largest descriptor) specified in a mask. 

A timeout value may be specified if the selection is not to last more than a predetermined 
period of time. If timeout is set to 0, the selection takes the form of a poll, returning immedi- 
ately. If the last parameter is a null pointer, the selection will block indefinitely*. Select 



W To be more specific, a return takes place only when a descriptor is selectable, or when a sig- 
nal is receiypd by the caller, interrupting the system call. 
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normally returns the number of file descriptors selected. If the aelect call returns due to the 
timeout expiring, then a value of -1 is returned along with the error number EINTR. 

Select provides a synchronous multiplexing scheme. Asynchronous notification of output com- 
pletion, input availability, and exceptional conditions is possible through use of the SIGIO and 
SIGURG signals described in section 5. 
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3. Network Library Routines 

The discussion in section 2 indicated the possible need to locate and construct network 
addresses when using the interprocess communication facilities in a distributed environment. 
To aid in this task a number of routines have been added to the standard C run-time library. 
In this section we will consider the new routines provided to manipulate network addresses. 
While the Sun system release networking facilities support only the DARPA standard Internet 
protocols, these routines have been designed with flexibility in mind. As more communication 
protocols become available, we hope the same user interface will be maintained in accessing 
network-related address data bases. The only difference should be the values returned to the 
user. Since these values are normally supplied the system, users should not need to be directly 
aware of the communication protocol and/or naming conventions in use. 

Locating a service on a remote host requires many levels of mapping before client and server 
may communicate. A service is assigned a name which is intended for human consumption; e.g. 
"the login server on host monet''. This name, and the name of the peer host, must then be 
translated into network addresses which are not necessarily suitable for human consumption. 
Finally, the address must then used in locating a physical location and route to the service. The 
specifics of these three mappings is likely to vary between network architectures. For instance, 
it is desirable for a network to not require hosts be named in such a way that their physical 
location is known by the client host. Instead, underlying services in the network may discover 
the actual location of the host at the time a client host wishes to communicate. This ability to 
have hosts named in a location independent manner may induce overhead in connection estab- 
lishment, as a discovery process must take place, but allows a host to be physically mobile 
without requiring it to notify its clientele of its current location. 

Standard routines are provided for: mapping host names to network addresses, network names 
to network numbers, protocol names to protocol numbers, and service names to port numbers 
and the appropriate protocol to use in communicating with the server process. The file 
<netdb.h> must be included when using any of these routines. 

3.1. Host Names 

A host name to address mapping is represented by the hoitent structure: 



struct hostent { 






char 


*h_name; 


/* official name of host */ 


char 


**h_aliases; 


/* alias list */ 


int 


h_addrtype; 


/* host address type ♦/ 


int 


hjength; 


/* length of address ♦/ 


char 


*h_addr; 


/* address */ 



}; 

Note that the hjaddr field in the structure definition is defined as a pointer to char. In the 
case of Internet addresses (the only case implemeted to date) you should cast this to a (struct 
in„addr *) when using the item. 

The official name of the host and its public aliases are returned, along with a variable length 
address and address type. The routine gethostbyname(^^) takes a host name and returns a hos- 
tent structure, while the routine gethosthyaddr{Z^) maps host addresses into a hostent structure. 
It is possible for a host to have many addresses, all having the same name. Gethostybyname 
returns the first matching entry in the data base file /etc/hosts; if this is unsuitable, the lower 
level routine gethosten^SN) may be used. For example, to obtain a hostent structure for a host 



^0 
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on a particular network the following routine might be used (for simplicity, only Internet 
addresses are considered): 

l^include <sys/types.h> 
^include <sys/socket.h> 
# include <netinet/in.h> 
^include <netdb.h> 

struct hostent * 
gethostbynameandnet(name, net) 

char 't'name; 

int net; 



{ 



register struct hostent *hp; 
register char **cp; 



sethostent(0); 

while ((hp = gethostent()) != NULL) { 

if (hp->h_addrtype !=- AF JNET) 

continue; 
if (strcmp(name, hp->h_name)) { 

for (cp = hp->h_aliases; cp && *cp !=« NULL; cp+ + ) 
if (strcmp(name, ♦cp) «»=« 0) 
goto found; 
continue; 

} 

found: 

if (in_netof(*(struct in_addr *)hp->h_addr)) ==* net) 
break; 

} 

endhostent(O); 
return (hp); 

} 

(mjnetof{3N) is a standard routine which returns the network portion of an Internet address.) 

3.2. Network Names 

As for host names, routines for mapping network names to numbers, and back, are provided. 
These routines return a netent structure: 
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* Assumption here is that a network number 

* fits in 32 bits — probably a poor one. 

*/ 

struct netent { 



char 


*n_name; 


char 


**n_aliases; 


int 


n_addrtype; 


int 


n_net; 



}; 



I* official name of net *l 
/♦ alias list ♦/ 
/* net address type ♦/ 
/♦ network # ♦/ 



The routines getnetbyname(ZH)y getntthynumhtr(ZH)y and gttnetent(Z^) arc the network coun- 
terparts to the host routines described above. 

3.3. Protocol Names 

For protocols the protoent structure defines the protocol-name mapping used with the routines 
g€tprotobyname(SN), getprotobynumber(SN), and getprotoent{Sli): 

struct protoent { 

/* official protocol name */ 
/* alias list */ 
/* protocol # */ 

}; 



char 


*p_name; 


char 


**p_aliases; 


int 


p^proto; 



3.4. Service Names 

Information regarding services is a bit more complicated. A service is expected to reside at a 
specific "port"' and employ a particular communication protocol. This view is consistent with 
the Internet domain, but inconsistent with other network architectures. Further, a service may 
reside on multiple ports or support multiple protocols. If either of these occurs, the higher level 
library routines will have to be bypassed in favor of homegrown routines similar in spirit to the 
"gethostbynameandnet" routine described above. A service mapping is described by the servent 
structure, 



/* official service name */ 

/* alias list ♦/ 

/* port # */ 

/* protocol to use ♦/ 



struct servent 


{ 




char 




*s_name; 


char 




**s_aliases; 


int 




s_port; 


char 




*s_proto; 



}; 



The routine g€t8crvbyname{SN) maps service names to a servent structure by specifying a ser- 
vice name and, optionally, a qualifying protocol. Thus the call 

sp = getservbynameC telnet", (char *)0); 
returns the service specification for a telnet server using any protocol, while the call 

sp == getservbynameC telnet", "^cp"); 
returns oply that telnet server which uses the TCP protocol. The routines yef«crv6yporl(3N) 



12 
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and getservent(SN) are also provided. The gctservbyport routine has an interface similar to that 
provided by geUervbyname; an optional protocol name may be specified to qualify lookups. 

3.5. Miscellaneous 

With the support routines described above, an application program should rarely have to deal 
directly with addresses. This allows services to be developed as much as possible in a network 
independent fashion. It is clear, however, that purging all network dependencies is very 
difficult. So long as the user is required to supply network addresses when naming services and 
sockets there will always some network dependency in a program. For example, the normal 
code included in client programs, such as the remote login program, is of the form shown in Fig- 
ure 1. (This example will be considered in more detail in section 4.) 

If we wanted to make the remote login program independent of the Internet protocols and 
addressing scheme we would be forced to add a layer of routines which masked the network 
dependent aspects from the mainstream login code. For the current facilities available in the 
system this does not appear to be worthwhile. Perhaps when the system is adapted to dififerent 
network architectures the utilities will be reorganized more cleanly. 

Aside from the address-related data base routines, there are several other routines available in 
the run-time library which are of interest to users. These are intended mostly to simplify mani- 
pulation of names and addresses. Table 1 summarizes the routines for manipulating variable 
length byte strings and handling byte swapping of network addresses and values. 

The bjrte swapping routines are provided because the operating system expects addresses to be 
supplied in network order. On a VAX, or machine with similar architecture, this is usually 
reversed. Consequently, programs are sometimes required to byte swap quantities. The library 
routines which return network addresses provide them in network order so that they may sim- 
ply be copied into the structures provided to the system. This implies users should encounter 
the byte swapping problem only when interpreting network addresses. For example, if an Inter- 
net port is to be printed out the following code would be required: 
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# include <sys/types.h> 
# include <sys/socket.h> 
^^include <netinet/in.h> 
5^include <stdio.h> 
# include <netdb.h> 

main(argc, argv) 

char *argvO; 



{ 



struct sockaddr_in sin; 
struct servent ♦sp; 
struct hostent *hp; 
int s; 

sp = getservbynameC login", "top"); 
if (sp == NULL) { 

fprintf(stderr, "rlogin: tcp/login: unknown serviceXn" ); 

exit(l); 

} 

hp = gethostbyname(argv[l]); 
if (hp == NULL) { 

fprintf(stderr, "rlogin: %5: unknown host\n'', argv[l]); 

exit(2); 

} 

bzero((char *)&sin, sizeof (sin)); 

bcopy(hp->h_addr, (char '<')&sin.sin_addr, hp->h_lcngth); 

sin.sin_family = hp->h_addrtype; 

sin.sin_port = sp->s_port; 

s = socket(AF JNET, SOCK.STREAM, 0); 

if (s < 0) { 

perrorC rlogin: socket"); 

exit(3); 

} 

if (connect(s, (char *)&;sin, sizeof (sin)) < 0) { 
perror(" rlogin: connect"); 
exit(5); 

> 



} 



Figure 1. Remote login client code. 
printf("port number %d\n", ntohs(sp->s_j>ort)); 
On machines other than the VAX these routines are defined as null macros. 
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Call 


Synopsis 


bcmp(sl, s2, n) 

bcopy(sl, s2, n) 

bzero(base, n) 

htonl(Yal) 

htons(Yal) 

ntohl(Yal) 

ntohs(Yal) 


compare byte-strings; if same, not otherwise 

copy n bytes from si to s2 

zero-fill n bytes starting at base 

conYcrt 32-bit quantity from host to network byte order 

conYcrt 16-bit quantity from host to network byte order 

couYcrt 32-bit quantity from network to host byte order 

conYert 16-bit quantity from network to host byte order 



Table 1. C run-time routines. 
4. Client/Server Model 

The most commonly used paradigm in constructing distributed applications is the client/serYer 
model. In this scheme client applications request services from a server process. This implies an 
asymmetry in establishing communication between the client and server which has been exam- 
ined in section 2. In this section we will look more closely at the interactions between client and 
server, and consider some of the problems in developing client and server applications. 

Client and server require a well known set of conventions before service may be rendered (and 
accepted). This set of conventions comprises a protocol which must be implemented at both 
ends of a connection. Depending on the situation, the protocol may be symmetric or asym- 
metric. In a symmetric protocol, either side may play the master or slave roles. In an asym- 
metric protocol, one side is immutably recognized as the master, with the other the slave. An 
example of a symmetric protocol is the TELNET protocol used in the Internet for remote termi- 
nal emulation. An example of an asymmetric protocol is the Internet file transfer protocol, 
FTP. No matter whether the specific protocol used in obtaining a service is symmetric or asym- 
metric, when accessing a service there is a "client process" and a "server process". We will first 
consider the properties of server processes, then client processes. 

A server process normally listens at a well know address for service requests. Alternative 
schemes which use a service server may be used to eliminate a flock of server processes clogging 
the system while remaining dormant most of the time. The Xerox Courier protocol uses the 
latter scheme. When using Courier, a Courier client process contacts a Courier server at the 
remote host and identifies the service it requires. The Courier server process then creates the 
appropriate server process based on a data base and "splices" the client and server together, 
voiding its part in the transaction. This scheme is attractive in that the Courier server process 
may provide a single contact point for all services, as well as carrying out the initial steps in 
authentication. However, while this is an attractive possibility for standardizing access to ser- 
vices, it does introduce a certain amount of overhead due to the intermediate process involved. 
Implementations which provide this type of service within the system can minimize the cost of 
client server rendezvous. 



4.1. Servers 

In this release, most servers are accessed at well known Internet addresses or UNIX domain 
names. When a server is started at boot time it advertises it services by listening at a well 
know location. For example, the remote login server's main loop is of the form shown in Figure 
2. 
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main(argc, argv) 
int argc; 
char **argv; 

{ 

int f; 

struct sockaddr_in from; 

struct servent *sp; 

sp == get servbynameC login", "tcp"); 
if (sp == NULL) { 

fprintf(stderr, "rlogind: tcp/login: unknown 8errice\n" ); 

exit(l); 
} 

#ifndef DEBUG 

<< disassociate server from controlling terminal >> 
#endif 

sin.sin_port = sp->s_port; 

f = socket(AF JNET, SOCK^STREAM, 0); 

if (bind(f, (caddr_t)&^sin, sizeof (sin)) < 0) { 

} 

listen(f, 5); 

for (;;) { 

int g, len = sizeof (from); 

g = accept(f, &;from, &len); 
if(g<0){ 

if (ermo != EINTR) 

perrorCrlogind: accept"); 

continue; 

} 

if (fork() == 0) { 

close(f); 

doit(g, fefrom); 

} 

close(g); 



} 



} 



Figure 2. Remote login server. 

The first step taken by the server is look up its service definition: 

sp = getservbynameC login", "tcp"); 
if (sp == NULL) { 
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fprintffstderr, "rlogind: tcp/login: unknown serviceXn" ); 
exit(l); 

} 

This definition is used in later portions of the code to define the Internet port at which it listens 
for service requests (indicated by a connection). 

Step two is to disassociate the server from the controlling terminal of its invoker. This is 
important as the server will likely not want to receive signals delivered to the process group of 
the controlling terminal. 

Once a server has established a pristine environment, it creates a socket and begins accepting 
service requests. The bind call is required to insure the server listens at its expected location. 
The main body of the loop is fairly simple: 

for (;;) { 

int g, len = sizeof (from); 

g = accept(f, &from, &Ien); 
if(g<0){ 

if (ermo != EINTR) 

perror("rlogind: accept"); 

continue; 

} 

if (fork() == 0) { 

close(f); 

doit(g, fefrom); 

} 

elose(g); 

} 

An accept call blocks the server until a client requests service. This call could return a failure 
status if the call is interrupted by a signal such as SIGCHLD (to be discussed in section 5). 
Therefore, the return value from accept is checked to insure a connection has actually been esta- 
blished. With a connection in hand, the server then forks a child process and invokes the main 
body of the remote lo^n protocol processing. Note how the socket used by the parent for 
queueing connection requests is closed in the child, while the socket created as a result of the 
accept is closed in the parent. The address of the client is also handed the doit routine because 
it requires it in authenticating clients. 

4.2. Clients 

The client side of the remote login service was shown earlier in Figure 1. One can see the 
separate, asymmetric roles of the client and server clearly in the code. The server is a passive 
entity, listening for client connections, while the client process is an active entity, initiating a 
connection when invoked. 

Let us consider more closely the steps taken by the client remote login process. As in the server 
process the first step is to locate the service definition for a remote login: 
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sp = getservbynameC login", "tcp"); 
if (gp === NULL) { 

fprintf(stderr, "rlogin: tcp/login: unknown 8ervice\n'*); 

exit(l); 

} 

Next the destination host is looked up with a gethottbynamc call: 

hp = gethostbyname(argv[l]); 
if (hp==NULL){ 

fprintf(stderr, "rlogin: %s: unknown host\n", argrfl]); 
exit(2); 
} 
With this accomplished, all that is required is to establish a connection to the server at the 
requested host and start up the remote login protocol. The address buffer is cleared, then filled 
in with the Internet address of the foreign host and the port number at which the login process 
resides: 

bzero((char *)&;sin, sizeof (sin)); 

bcopy(hp->h_addr, (char *)sin.sin_addr, hp->hjength); 

sin.sin_family == hp->h_addrtype; 

sin.sin_port = sp->sjport; 

A socket is created, and a connection initiated. 

s = socket(hp->h_addrtype, SOCK_STREAM, 0); 
if (s < 0) { 

perror(" rlogin: socket"); 

exit(3); 
} 

if (connect(s, (char *)&;sin, sizeof (sin)) < 0) { 
perror(" rlogin: connect"); 
exit(4); 

} 

The details of the remote login protocol will not be considered here. 

4.3. Connectionless Servers 

While connection-based services are the norm, some services are based on the use of datagram 
sockets. One, in particular, is the "rwho" service which provides users with status information 
for hosts connected to a local area network. This service, while predicated on the ability to 
broadcast information to all hosts connected to a particular network, is of interest as an exam- 
ple usage of datagram sockets. 

A user on any machine running the rwho server may find out the current status of a machine 
with the ruptim€(l) program. The output generated is illustrated in Figure 3. 

Status information for each host is periodically broadcast by rwho server processes on each 
machine. The same server process also receives the status information and uses it to update a 
database. This database is then interpreted to generate the status information for each host. 
Servers operate autonomously, coupled only by the local network and its broadcast capabilities. 
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arpa 


up 


9:45, 


5 users, load 


1.15, 


1.39, 


1.31 


cad 


up 


2+ 12:04, 


8 users, load 


4.67, 


5.13, 


4.59 


calder 


up 


10:10, 


users, load 


0.27, 


0.15, 


0.14 


dali 


up 


2+ 06:28, 


9 users, load 


1.04, 


1.20, 


1.65 


degas 


up 


25+ 09:48, 


users, load 


1.49, 


1.43, 


1.41 


ear 


up 


5+ 00:05, 


users, load 


1.51, 


1.54, 


1.56 


emie 


down 


0:24 










esvax 


down 


17:04 










ingres 


down 


0:26 










kim 


up 


3+ 09:16, 


8 users, load 


2.03, 


2.46, 


3.11 


matisse 


up 


3+ 06:18, 


users, load 


0.03, 


0.03, 


0.05 


medea 


up 


3+ 09:39, 


2 users, load 


0.35, 


0.37, 


0.50 


merlin 


down 


19+ 15:37 










miro 


up 


1+ 07:20, 


7 users, load 


4.59, 


3.28, 


2.12 


monet 


up 


1+ 00:43, 


2 users, load 


0.22, 


0.09, 


0.07 


oz 


down 


16:09 










statvax 


up 


2+ 15:57, 


3 users, load 


1.52, 


1.81, 


1.86 


ucbvax 


up 


9:34, 


2 users, load 


6.08, 


5.16, 


3.28 



Figure 3. ruptime output. 



The rwho server, in a simplified form, is pictured in Figure 4. There are two separate tasks per- 
formed by the server. The first task is to act as a receiver of status information broadcast by 
other hosts on the network. This job is carried out in the main loop of the program. Packets 
received at the rwho port are interrogated to insure they've been sent by another rwho server 
process, then are time stamped with their arrival time and used to update a file indicating the 
status of the host. When a host has not been heard from for an extended period of time, the 
database interpretation routines assume the host is down and indicate such on the status 
reports. This algorithm is prone to error as a server may be down while a host is actually up, 
but serves our current needs. 

The second task performed by the server is to supply information regarding the status of its 
host. This involves periodically acquiring system status information, packaging it up in a mes- 
sage and broadcasting it on the local network for other rwho servers to hear. The supply func- 
tion is triggered by a timer and runs off a signal. Locating the system status information is 
somewhat involved, but uninteresting. Deciding where to transmit the resultant packet does, 
however, indicates some problems with the current protocol. 

Status information is broadcast on the local network. For networks which do not support the 
notion of broadcast another scheme must be used to simulate or replace broadcasting. One pos- 
sibility is to enumerate the known neighbors (based on the status received). This, unfor- 
tunately, requires some bootstrapping information, as a server started up on a quiet network 
will have no known neighbors and thus never receive, or send, any status information. This is 
the identical problem faced by the routing table management process in propagating routing 
status information. The standard solution, unsatisfactory as it may be, is to inform one or 
more servers of known neighbors and request that they always communicate with these neigh- 
bors. If each server has at least one neighbor supplying it, status information may then pro- 
pagate through a neighbor to hosts which are not (possibly) directly neighbors. If the server is 
able to support networks which provide a broadcast capability, as well as those which do not, 
then networks with an arbitrary topology may share status information*. 



^ * One must, however, be concerned about "loops", 
networks, it will receive status information from itself. 

Revision E of 7 January 1984 



That is, if a host is connected to multiple 
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main() 

{ 



sp = getservbynameCwho", "udp"); 

net = getnetbynameClocalnet"); 

sin.sin_addr = inet_makeaddr(INADDR_ANY, net); 

sin.sin_port == sp->s_port; 

s = socket(AFJNET, SOCK^DGRAM, 0); 

bind(s, &sin, sizeof (sin)); 

sigset(SIGALRM, onalrm); 

onalrm(); 

for (;;) { 

struct whod wd; 

int cc, whod, len = sizeof (from); 

cc = recvfrom(s, (char *)&:wd, sizeof (struct whod), 0, &from, &Ien); 
if (cc <== 0) { 

if (cc < && errno != EINTR) 
perrorCrwhod: recv"); 

continue; 

} 

if (from.sin_j)ort != sp->s_port) { 

fprintf(stderr, "rwhod: %d: bad from port\n'', 

ntohs(from .sin_port)); 
continue; 

} 

if (!verify(wd.wd_hostname)) { 

fprintf(stderr, "rwhod: malformed host name from %x\n'', 

ntohl(from.sinjaddr.s_addr)); 
continue; 

} 

(void) sprintf(path, "^s/whod.^s", RWHODIR, wd.wd_hostname); 

whod = open(path, 0_FWRONLY|0_FCREATE|0_FTRUNCATE, 0666); 

(void) time(&;wd.wd_recvtime); 
(void) write(whod, (char *)&wd, cc); 
(void) close(whod); 



Figure 4. rwho server. 



change of information. 
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The second problem with the current scheme is that the rwho process services only a single local 
network, and this network is found by reading a file. It is important that software operating in 
a distributed environment not have any site- dependent information compiled into it. This 
would require a separate copy of the server at each host and make maintenance a severe 
hesuiache. The Sun system attempts to isolate host-specific information from applications by 
providing system calls which return the necessary informationf. The rwho server performs a 
lookup in a file to find its local network. A better, though still unsatisfactory, scheme used by 
the routing process is to interrogate the system data structures to locate those directly con- 
nected networks. A mechanism to acquire this information from the system would be a useful 
addition. 



^ t An example of such a system call is the getko$tname{2) call which returns the host's "official" 
name. 
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5. Advanced Topics 

A number of facilities have yet to be discussed. For most users of the ipc the mechanisms 
already described will suffice in constructing distributed applications. However, others will find 
need to utilize some of the features which we consider in this section. 



5.1. Out of Band Data 

The stream socket abstraction includes the notion of "out of band" data. Out of band data is a 
logically independent transmission channel associated with each pair of connected stream sock- 
ets. Out of band data is delivered to the user independently of normal data along with the 
SIGURG signal. In addition to the information passed, a logical mark is placed in the data 
stream to indicate the point at which the out of band data was sent. The remote login and 
remote shell applications use this facility to propagate signals from between client and server 
processes. When a signal is expected to flush any pending output from the remote process(es), 
all data up to the mark in the data stream is discarded. 

The stream abstraction defines that the out of band data facilities must support the reliable 
delivery of at least one out of band message at a time. This message may contain at least one 
byte of data, and at least one message may be pending delivery to the user at any one time. 
For communications protocols which support only in-band signaling (that is, the urgent data is 
delivered in sequence with the normal data) the system extracts the data from the normal data 
stream and stores it separately. This allows users to choose between receiving the urgent data 
in order and receiving it out of sequence without having to bufiier all the intervening data. 

To send an out of band message the MSG_OOB flag is supplied to a send or tendto calls, while 
to receive out of band data MSG_OOB should be indicated when performing a recvfrom or recv 
call. To find out if the read pointer is currently pointing at the mark in the data stream, the 
SIOCATMARK ioctl is provided: 

ioctl(s, SIOCATMARK, feyes); 

If yea is a 1 on return, the next read will return data after the mark. Otherwise (assuming out 
of band data has arrived), the next read will provide data sent by the client prior to transmis- 
sion of the out of band signal. The routine used in the remote login process to flush output on 
receipt of an interrupt or quit signal is shown in Figure 5. 

5.2. Signals and Process Groups 

Due to the existence of the SIGURG and SIGIO signals each socket has an associated process 
group (just as is done for terminals). This process group is initialized to the process group of its 
creator, but may be redefined at a later time with the SIOCSPGRP ioctl: 
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oob() 

{ 



int out = 1+ 1; 

char waste[BUFSIZ], mark; 

8ignal(SIGURG, oob); 
I* flush local terminal input and output */ 
ioctl(l, TIOCFLUSH, (char *)&out); 
for (;;) { 

if (ioctl(rem, SIOCATMARK, femark) < 0) { 

perrorCioctr); 

break; 

} 

if (mark) 

break; 
(void) read(rem, waste, sizeof (waste)); 

} 

recv(rem, &mark, 1, MSG_OOB); 



Figure 5. Flushing terminal i/o on receipt of out of band data. 

ioctl(s, SIOCSPGRP, fepgrp); 
A similar ioctl, SIOCGPGRP, is available for determining the current process group of a socket. 



Many programs will not function properly without a terminal for standard input and output. 
Since a socket is not a terminal, it is often necessary to have a process communicating over the 
network do so through a pseudo UrminaL A pseudo terminal is actually a pair of devices, mas- 
ter and slave, which allow a process to serve as an active agent in communication between 
processes and users. Data written on the slave side of a pseudo terminal is supplied as input to 
a process reading from the master side. Data written on the master side is given the slave as 
input. In this way, the process manipulating the master side of the pseudo terminal has control 
over the information read and written on the slave side. The remote login server uses pseudo 
terminals for remote login sessions. A user logging in to a machine across the network is pro- 
vided a shell with a slave pseudo terminal as standard input, output, and error. The server pro- 
cess then hs^^dles the communication between the programs invoked by the remote shell and the 
user's local client process. When a user sends an interrupt or quit signal to a process executing 
on a remote machine, the client login program traps the signal, sends an out of band message to 
the server process who then uses the signal number, sent as the data value in the out of band 
message, to perform a killp^2) on the appropriate process group. 
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5.4. Internet Address Binding 

Binding addresses to sockets in the Internet domain can be fairly complex. Communicating 
processes are bound by an association. An association is composed of local and foreign 
addresses, and local and foreign ports. Port numbers are allocated out of separate spaces, one 
for each Internet protocol. Associations are always unique. That is, there may never be dupli- 
cate <protocol, local address, local port, foreign address, foreign port> tuples. 

The bind system call allows a process to specify half of an association, <local address, local 
port>, while the connect and accept primitives are used to complete a socket's association. 
Since the association is created in two steps the association uniqueness requirement indicated 
above could be violated unless care is taken. Further, it is unrealistic to expect user programs 
to always know proper values to use for the local address and local port since a host may reside 
on multiple networks and the set of allocated port numbers is not directly accessible to a user. 

To simplify local address binding the notion of a "wildcard" address has been provided. When 
an address is specified as INADDR_ANY (a manifest constant defined in <netinet/in.h>), the 
system interprets the address as "any valid address". For example, to bind a specific port 
number to a socket, but leave the local address unspecified, the following code might be used: 

^include <sys/types.h> 
T^include <netinet/in.h> 

struct sockaddrjn sin; 

s = socket(AF_INET, SOCK_STREAM, 0); 
sin.sin Jamily = AF JNET; 
sin.sin_addr.s_addr = INADDR.ANY; 
sin.sin_port = MYPORT; 
bind(s, (char *)&;sin, sizeof (sin)); 

Sockets with wildcarded local addresses may receive messages directed to the specified port 
number, and addressed to any of the possible addresses assigned a host. For example, if a host 
is on networks 40 and 10 and a socket is bound as above, then an accept call is performed, the 
process will be able to accept connection requests which arrive either from network 46 or net- 
work 10. 

In a similar fashion, a local port may be left unspecified (specified as zero), in which case the 
system will select an appropriate port number for it. For example: 

sin.sin_addr.s_addr == MYADDRESS; 

sin.sin_jport = 0; 

bind(s, (char *)&;sin, sizeof (sin)); 

The system selects the port number based on two criteria. The first is that ports numbered 
through IPP0RT_RESERVED-1 are reserved for privileged users (that is, the super user). The 
second is that the port number is not currently bound to some other socket. In order to find a 
free port number in the privileged range the following code is used by the remote shell server: 
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struct sockaddr_in sin; 

Iport = IPPORT_RESERVED - 1; 
sin.sin_addr.s_^addr == INADDR_ANY; 

for(;;){ 

sin.sin_port *= litons((uj5hort)lport); 

if (bind(s, (caddr_t)&;sin, sizeof (sin)) >=■ 0) 

break; 
if (errno !=- EADDRINUSE && crrno !« EADDRNOTAVAIL) { 

perrorC* socket"); 

break; 

} 

Iport--; 

if (Iport =^ IPPORT_RESERVED/2) { 

fprintf(stderr, "socket: All ports in use\n"); 

break; 

} 
} 

The restriction on allocating ports was done to allow processes executing in a "secure*' environ- 
ment to perform authentication based on the originating address and port number. 

In certain cases the algorithm used by the system in selecting port numbers is unsuitable for an 
application. This is due to associations being created in a two step process. For example, the 
Internet file transfer protocol, FTP, specifies that data connections must always originate from 
the same local port. However, duplicate associations are avoided by connecting to different 
foreign ports. In this situation the system would disallow binding the same local address and 
port number to a socket if a previous data connection's socket were around. To override the 
default port selection algorithm then an option call must be performed prior to address binding: 

setsockopt(s, SOL_SOCKET, SO_REUSEADDR, (char *)0, 0); 
bind(s, (char *)&sin, sizeof (sin)); 

With the above call, local addresses may be bound which are already in use. This does not 
violate the uniqueness requirement as the system still checks at connect time to be sure any 
other sockets with the same local address and port do not have the same foreign address and 
port (if an association already exists, the error EADDRINUSE is returned). 

Local address binding by the system is currently done somewhat haphazardly when a host is on 
multiple networks. Logically, one would expect the system to bind the local address associated 
with the network through which a peer was communicating. For instance, if the local host is 
connected to networks 46 and 10 and the foreign host is on network 32, and traffic from net- 
work 32 were arriving via network 10, the local address to be bound would be the host's address 
on network 10, not network 46. This unfortunately, is not always the case. For reasons too 
complicated to discuss here, the local address bound may be appear to be chosen at random. 
This property of local address binding will normally be invisible to users unless the foreign host 
does not understand how to reach the address selected'*'. 



^ • For example, if network 46 were unknown to the host on network 32, and the local address 
were bound to that located on network 46, then even though a route between the two hosts existed 
through network 10, a connection would faU. 
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5.5. Broadcasting and Datagram Sockets 

By using a datagram socket it is possible to send broadcast packets on many networks sup- 
ported by the system (the network itself must support the notion of broadcasting; the system 
provides no broadcast simulation in software). Broadcast messages can place a high load on a 
network since they force every host on the network to service them. 

To send a broadcast message, an Internet datagram socket should be created: 

s = socket(AFJNET, SOCK.DGRAM, 0); 

and at least a port number should be bound to the socket: 

sin.sin_family = AFJNET; 
sin.sin_addr.s_addr = INADDR_ANY; 
sin.sin_port = MYPORT; 
bind(s, (char '»)&sin, sizeof (sin)); 

Then the message should be addressed as: 

dst.sinjamily = AFJNET; 
inet_makeaddr(net, INADDR_ANY); 
dst.sin_port = DESTPORT; 

and, finally, a sendto call may be used: 

sendto(s, buf, buflen, 0, &dst, sizeof (dst)); 

Received broadcast messages contain the senders address and port (datagram sockets are 
anchored before a message is allowed to go out). 

There are a couple of minor problems in the above example. One is created because 
INADDR_ANY has two meanings: 

1. Fill in my own address, and, 

2. Broadcast. 

Unfortunately, broadcast must at some time in the future be changed to -1 instead of 0, so that 
broadcast will no longer be The second problem is how do you get your net number? You could 
use the SIOCGICONF ioctl call, or you could get your own address and do a inetjnttof on that. 
INADDRJVNY. 

5.6. Signals 

Two new signals have been added to the system which may be used in conjunction with the 
interprocess communication facilities. The SIGURG signal is associated with the existence of an 
"urgent condition". The SIGIO signal is used with "interrupt driven i/o" (not presently imple- 
mented). SIGURG is currently supplied a process when out of band data is present at a socket. 
If multiple sockets have out of band data awaiting delivery, a select call may be used to deter* 
mine those sockets with such data. 

An old signal which is useful when constructing server processes is SIGCHLD. This signal is 
delivered to a process when any children processes have changed state. Normally servers use 
the signal to "reap" child processes after exiting. For example, the remote lo^n server loop 
shown in Figure 2 may be augmented as follows: 
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int reaper(); 

signal(SIGCHLD, reaper); 
listen(f, 10); 
for (;;) { 

int g, len == sizeof (from); 

g = accept{f, &from, felen, 0); 
if(g<0){ 

if (ermo != EINTR) 

perrorCrlogind: accept"); 

continue; 

. } 
} 

^include <wait.h> 
reaper() 

{ 

union wait status; 

while (wait3(&status, WNOHANG, 0) > 0) 

» 

} 

If the parent server process fails to reap its children, a large number of "zombie" processes may 
be created. 
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